AccessAnalyzer / Client / list_access_previews

list_access_previews#

AccessAnalyzer.Client.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