list_access_previews

list_access_previews(**kwargs)

Retrieves a list of access previews for the specified analyzer.

See also: AWS API Documentation

Request Syntax

response = client.list_access_previews(
    analyzerArn='string',
    nextToken='string',
    maxResults=123
)
Parameters
  • analyzerArn (string) --

    [REQUIRED]

    The ARN of the analyzer used to generate the access preview.

  • nextToken (string) -- A token used for pagination of results returned.
  • maxResults (integer) -- The maximum number of results to return in the response.
Return type

dict

Returns

Response Syntax

{
    'accessPreviews': [
        {
            'id': 'string',
            'analyzerArn': 'string',
            'createdAt': datetime(2015, 1, 1),
            'status': 'COMPLETED'|'CREATING'|'FAILED',
            'statusReason': {
                'code': 'INTERNAL_ERROR'|'INVALID_CONFIGURATION'
            }
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • accessPreviews (list) --

      A list of access previews retrieved for the analyzer.

      • (dict) --

        Contains a summary of information about an access preview.

        • id (string) --

          The unique ID for the access preview.

        • analyzerArn (string) --

          The ARN of the analyzer used to generate the access preview.

        • createdAt (datetime) --

          The time at which the access preview was created.

        • status (string) --

          The status of the access preview.

          • Creating - The access preview creation is in progress.
          • Completed - The access preview is complete and previews the findings for external access to the resource.
          • Failed - The access preview creation has failed.
        • statusReason (dict) --

          Provides more details about the current status of the access preview. For example, if the creation of the access preview fails, a Failed status is returned. This failure can be due to an internal issue with the analysis or due to an invalid proposed resource configuration.

          • code (string) --

            The reason code for the current status of the access preview.

    • nextToken (string) --

      A token used for pagination of results returned.

Exceptions

  • AccessAnalyzer.Client.exceptions.ResourceNotFoundException
  • AccessAnalyzer.Client.exceptions.ValidationException
  • AccessAnalyzer.Client.exceptions.InternalServerException
  • AccessAnalyzer.Client.exceptions.ThrottlingException
  • AccessAnalyzer.Client.exceptions.AccessDeniedException