Macie2 / Paginator / ListResourceProfileDetections

ListResourceProfileDetections#

class Macie2.Paginator.ListResourceProfileDetections#
paginator = client.get_paginator('list_resource_profile_detections')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from Macie2.Client.list_resource_profile_detections().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    resourceArn='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • resourceArn (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the S3 bucket that the request applies to.

  • PaginationConfig (dict) –

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) –

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) –

      The size of each page.

    • StartingToken (string) –

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'detections': [
        {
            'arn': 'string',
            'count': 123,
            'id': 'string',
            'name': 'string',
            'suppressed': True|False,
            'type': 'CUSTOM'|'MANAGED'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    The request succeeded.

    • detections (list) –

      An array of objects, one for each type of sensitive data that Amazon Macie found in the bucket. Each object reports the number of occurrences of the specified type and provides information about the custom data identifier or managed data identifier that detected the data.

      • (dict) –

        Provides information about a type of sensitive data that Amazon Macie found in an S3 bucket while performing automated sensitive data discovery for the bucket. The information also specifies the custom data identifier or managed data identifier that detected the data. This information is available only if automated sensitive data discovery is currently enabled for your account.

        • arn (string) –

          If the sensitive data was detected by a custom data identifier, the Amazon Resource Name (ARN) of the custom data identifier that detected the data. Otherwise, this value is null.

        • count (integer) –

          The total number of occurrences of the sensitive data.

        • id (string) –

          The unique identifier for the custom data identifier or managed data identifier that detected the sensitive data. For additional details about a specified managed data identifier, see Using managed data identifiers in the Amazon Macie User Guide.

        • name (string) –

          The name of the custom data identifier or managed data identifier that detected the sensitive data. For a managed data identifier, this value is the same as the unique identifier (id).

        • suppressed (boolean) –

          Specifies whether occurrences of this type of sensitive data are excluded (true) or included (false) in the bucket’s sensitivity score.

        • type (string) –

          The type of data identifier that detected the sensitive data. Possible values are: CUSTOM, for a custom data identifier; and, MANAGED, for a managed data identifier.

    • NextToken (string) –

      A token to resume pagination.