Lists the permissions an account has to configure Amazon Inspector. If the account is a member account or standalone account with resources managed by an Organizations policy, the operation returns fewer permissions.
Parameters:
-
service
(Optional[Service], default:
None
)
–
The service scan type to check permissions for.
-
max_results
(Optional[ListAccountPermissionsMaxResults], default:
None
)
–
The maximum number of results the response can return. If your request would return more than the maximum the response will return a nextToken value, use this value when you call the action again to get the remaining results.
-
next_token
(Optional[NextToken], default:
None
)
–
A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request to a list action. If your response returns more than the maxResults maximum value it will also return a nextToken value. For subsequent calls, use the NextToken value returned from the previous request to continue listing results after the first page.
Raises:
-
AccessDeniedException
–
You do not have sufficient access to perform this action.
For Enable, you receive this error if you attempt to use a feature in an unsupported Amazon Web Services Region.
-
InternalServerException
–
The request has failed due to an internal failure of the Amazon Inspector service.
-
ThrottlingException
–
The limit on the number of requests per second was exceeded.
-
ValidationException
–
The request has failed validation due to missing required fields or having invalid inputs.
-
UnknownServiceError
–
The service returned an error code this client does not model.
Source code in docs_src/capo_inspector2/_services/inspector2.py
| def list_account_permissions(
self,
*,
config_overrides: Optional[Inspector2ClientConfig] = None,
service: Optional["capo_inspector2.types.service.Service"] = None,
max_results: Optional[
"capo_inspector2.types.list_account_permissions_max_results.ListAccountPermissionsMaxResults"
] = None,
next_token: Optional["capo_inspector2.types.next_token.NextToken"] = None,
) -> "capo_inspector2.types.list_account_permissions_response.ListAccountPermissionsResponse":
"""<p> Lists the permissions an account has to configure Amazon Inspector. If the account is a member account or standalone account with resources managed by an Organizations policy, the operation returns fewer permissions. </p>
Args:
service: <p>The service scan type to check permissions for.</p>
max_results: <p>The maximum number of results the response can return. If your request would return more than the maximum the response will return a <code>nextToken</code> value, use this value when you call the action again to get the remaining results.</p>
next_token: <p>A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request to a list action. If your response returns more than the <code>maxResults</code> maximum value it will also return a <code>nextToken</code> value. For subsequent calls, use the NextToken value returned from the previous request to continue listing results after the first page.</p>
Raises:
capo_inspector2.errors.access_denied_exception.AccessDeniedException: <p>You do not have sufficient access to perform this action.</p> <p> For <code>Enable</code>, you receive this error if you attempt to use a feature in an unsupported Amazon Web Services Region. </p>
capo_inspector2.errors.internal_server_exception.InternalServerException: <p>The request has failed due to an internal failure of the Amazon Inspector service.</p>
capo_inspector2.errors.throttling_exception.ThrottlingException: <p>The limit on the number of requests per second was exceeded.</p>
capo_inspector2.errors.validation_exception.ValidationException: <p>The request has failed validation due to missing required fields or having invalid inputs.</p>
capo_inspector2.errors.UnknownServiceError: The service returned an error code this client does not model.
"""
def _handler(
req: "OperationRequest[capo_inspector2.types.list_account_permissions_request.ListAccountPermissionsRequest]",
) -> OperationResponse[
"capo_inspector2.types.list_account_permissions_response.ListAccountPermissionsResponse"
]:
import capo_inspector2._operations.inspector2.list_account_permissions
output, http_response = (
capo_inspector2._operations.inspector2.list_account_permissions.list_account_permissions(
req.options, req.input
)
)
return OperationResponse(output=output, response=http_response)
interceptors_, options_ = self.operation_options(
config_overrides, OperationLogging("ListAccountPermissions")
)
input_: capo_inspector2.types.list_account_permissions_request.ListAccountPermissionsRequest = {}
if service is not None:
input_["service"] = service
if max_results is not None:
input_["max_results"] = max_results
if next_token is not None:
input_["next_token"] = next_token
response = execute_pipeline(
OperationRequest(input=input_, options=options_),
handler=_handler,
interceptors=list(interceptors_),
)
response.response.close()
return response.output
|