Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

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