Macie2

Client

class Macie2.Client

A low-level client representing Amazon Macie 2

Amazon Macie is a fully managed data security and data privacy service that uses machine learning and pattern matching to discover and protect your sensitive data in AWS. Macie automates the discovery of sensitive data, such as PII and intellectual property, to provide you with insight into the data that your organization stores in AWS. Macie also provides an inventory of your Amazon S3 buckets, which it continually monitors for you. If Macie detects sensitive data or potential data access issues, it generates detailed findings for you to review and act upon as necessary.

client = session.create_client('macie2')

These are the available methods:

accept_invitation(**kwargs)

Accepts an Amazon Macie membership invitation that was received from a specific account.

See also: AWS API Documentation

Request Syntax

response = client.accept_invitation(
    administratorAccountId='string',
    invitationId='string',
    masterAccount='string'
)
Parameters
  • administratorAccountId (string) -- The Amazon Web Services account ID for the account that sent the invitation.
  • invitationId (string) --

    [REQUIRED]

    The unique identifier for the invitation to accept.

  • masterAccount (string) -- (Deprecated) The Amazon Web Services account ID for the account that sent the invitation. This property has been replaced by the administratorAccountId property and is retained only for backward compatibility.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

    The request succeeded and there isn't any content to include in the body of the response (No Content).

Exceptions

batch_get_custom_data_identifiers(**kwargs)

Retrieves information about one or more custom data identifiers.

See also: AWS API Documentation

Request Syntax

response = client.batch_get_custom_data_identifiers(
    ids=[
        'string',
    ]
)
Parameters
ids (list) --

An array of custom data identifier IDs, one for each custom data identifier to retrieve information about.

  • (string) --
Return type
dict
Returns
Response Syntax
{
    'customDataIdentifiers': [
        {
            'arn': 'string',
            'createdAt': datetime(2015, 1, 1),
            'deleted': True|False,
            'description': 'string',
            'id': 'string',
            'name': 'string'
        },
    ],
    'notFoundIdentifierIds': [
        'string',
    ]
}

Response Structure

  • (dict) --

    The request succeeded.

    • customDataIdentifiers (list) --

      An array of objects, one for each custom data identifier that meets the criteria specified in the request.

      • (dict) --

        Provides information about a custom data identifier.

        • arn (string) --

          The Amazon Resource Name (ARN) of the custom data identifier.

        • createdAt (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when the custom data identifier was created.

        • deleted (boolean) --

          Specifies whether the custom data identifier was deleted. If you delete a custom data identifier, Amazon Macie doesn't delete it permanently. Instead, it soft deletes the identifier.

        • description (string) --

          The custom description of the custom data identifier.

        • id (string) --

          The unique identifier for the custom data identifier.

        • name (string) --

          The custom name of the custom data identifier.

    • notFoundIdentifierIds (list) --

      An array of custom data identifier IDs, one for each custom data identifier that was specified in the request but doesn't correlate to an existing custom data identifier.

      • (string) --

Exceptions

can_paginate(operation_name)

Check if an operation can be paginated.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Returns
True if the operation can be paginated, False otherwise.
create_classification_job(**kwargs)

Creates and defines the settings for a classification job.

See also: AWS API Documentation

Request Syntax

response = client.create_classification_job(
    clientToken='string',
    customDataIdentifierIds=[
        'string',
    ],
    description='string',
    initialRun=True|False,
    jobType='ONE_TIME'|'SCHEDULED',
    managedDataIdentifierIds=[
        'string',
    ],
    managedDataIdentifierSelector='ALL'|'EXCLUDE'|'INCLUDE'|'NONE',
    name='string',
    s3JobDefinition={
        'bucketDefinitions': [
            {
                'accountId': 'string',
                'buckets': [
                    'string',
                ]
            },
        ],
        'scoping': {
            'excludes': {
                'and': [
                    {
                        'simpleScopeTerm': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'key': 'OBJECT_EXTENSION'|'OBJECT_LAST_MODIFIED_DATE'|'OBJECT_SIZE'|'OBJECT_KEY',
                            'values': [
                                'string',
                            ]
                        },
                        'tagScopeTerm': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'key': 'string',
                            'tagValues': [
                                {
                                    'key': 'string',
                                    'value': 'string'
                                },
                            ],
                            'target': 'S3_OBJECT'
                        }
                    },
                ]
            },
            'includes': {
                'and': [
                    {
                        'simpleScopeTerm': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'key': 'OBJECT_EXTENSION'|'OBJECT_LAST_MODIFIED_DATE'|'OBJECT_SIZE'|'OBJECT_KEY',
                            'values': [
                                'string',
                            ]
                        },
                        'tagScopeTerm': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'key': 'string',
                            'tagValues': [
                                {
                                    'key': 'string',
                                    'value': 'string'
                                },
                            ],
                            'target': 'S3_OBJECT'
                        }
                    },
                ]
            }
        },
        'bucketCriteria': {
            'excludes': {
                'and': [
                    {
                        'simpleCriterion': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'key': 'ACCOUNT_ID'|'S3_BUCKET_NAME'|'S3_BUCKET_EFFECTIVE_PERMISSION'|'S3_BUCKET_SHARED_ACCESS',
                            'values': [
                                'string',
                            ]
                        },
                        'tagCriterion': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'tagValues': [
                                {
                                    'key': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                ]
            },
            'includes': {
                'and': [
                    {
                        'simpleCriterion': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'key': 'ACCOUNT_ID'|'S3_BUCKET_NAME'|'S3_BUCKET_EFFECTIVE_PERMISSION'|'S3_BUCKET_SHARED_ACCESS',
                            'values': [
                                'string',
                            ]
                        },
                        'tagCriterion': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'tagValues': [
                                {
                                    'key': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                ]
            }
        }
    },
    samplingPercentage=123,
    scheduleFrequency={
        'dailySchedule': {}
        ,
        'monthlySchedule': {
            'dayOfMonth': 123
        },
        'weeklySchedule': {
            'dayOfWeek': 'SUNDAY'|'MONDAY'|'TUESDAY'|'WEDNESDAY'|'THURSDAY'|'FRIDAY'|'SATURDAY'
        }
    },
    tags={
        'string': 'string'
    }
)
Parameters
  • clientToken (string) --

    [REQUIRED]

    A unique, case-sensitive token that you provide to ensure the idempotency of the request.

    This field is autopopulated if not provided.

  • customDataIdentifierIds (list) --

    An array of unique identifiers, one for each custom data identifier for the job to use when it analyzes data. To use only managed data identifiers, don't specify a value for this property and specify a value other than NONE for the managedDataIdentifierSelector property.

    • (string) --
  • description (string) -- A custom description of the job. The description can contain as many as 200 characters.
  • initialRun (boolean) --

    For a recurring job, specifies whether to analyze all existing, eligible objects immediately after the job is created (true). To analyze only those objects that are created or changed after you create the job and before the job's first scheduled run, set this value to false.

    If you configure the job to run only once, don't specify a value for this property.

  • jobType (string) --

    [REQUIRED]

    The schedule for running the job. Valid values are:

    • ONE_TIME - Run the job only once. If you specify this value, don't specify a value for the scheduleFrequency property.
    • SCHEDULED - Run the job on a daily, weekly, or monthly basis. If you specify this value, use the scheduleFrequency property to define the recurrence pattern for the job.
  • managedDataIdentifierIds (list) --

    An array of unique identifiers, one for each managed data identifier for the job to include (use) or exclude (not use) when it analyzes data. Inclusion or exclusion depends on the managed data identifier selection type that you specify for the job (managedDataIdentifierSelector).

    To retrieve a list of valid values for this property, use the ListManagedDataIdentifiers operation.

    • (string) --
  • managedDataIdentifierSelector (string) --

    The selection type to apply when determining which managed data identifiers the job uses to analyze data. Valid values are:

    • ALL - Use all the managed data identifiers that Amazon Macie provides. If you specify this value, don't specify any values for the managedDataIdentifierIds property.
    • EXCLUDE - Use all the managed data identifiers that Macie provides except the managed data identifiers specified by the managedDataIdentifierIds property.
    • INCLUDE - Use only the managed data identifiers specified by the managedDataIdentifierIds property.
    • NONE - Don't use any managed data identifiers. If you specify this value, specify at least one custom data identifier for the job (customDataIdentifierIds) and don't specify any values for the managedDataIdentifierIds property.

    If you don't specify a value for this property, the job uses all managed data identifiers. If you don't specify a value for this property or you specify ALL or EXCLUDE for a recurring job, the job also uses new managed data identifiers as they are released.

  • name (string) --

    [REQUIRED]

    A custom name for the job. The name can contain as many as 500 characters.

  • s3JobDefinition (dict) --

    [REQUIRED]

    The S3 buckets that contain the objects to analyze, and the scope of that analysis.

    • bucketDefinitions (list) --

      An array of objects, one for each Amazon Web Services account that owns specific S3 buckets to analyze. Each object specifies the account ID for an account and one or more buckets to analyze for that account. A job's definition can contain a bucketDefinitions array or a bucketCriteria object, not both.

      • (dict) --

        Specifies an Amazon Web Services account that owns S3 buckets for a classification job to analyze, and one or more specific buckets to analyze for that account.

        • accountId (string) -- [REQUIRED]

          The unique identifier for the Amazon Web Services account that owns the buckets.

        • buckets (list) -- [REQUIRED]

          An array that lists the names of the buckets.

          • (string) --
    • scoping (dict) --

      The property- and tag-based conditions that determine which S3 objects to include or exclude from the analysis. Each time the job runs, the job uses these criteria to determine which objects to analyze.

      • excludes (dict) --

        The property- and tag-based conditions that determine which objects to exclude from the analysis.

        • and (list) --

          An array of conditions, one for each property- or tag-based condition that determines which objects to include or exclude from the job. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

          • (dict) --

            Specifies a property- or tag-based condition that defines criteria for including or excluding S3 objects from a classification job. A JobScopeTerm object can contain only one simpleScopeTerm object or one tagScopeTerm object.

            • simpleScopeTerm (dict) --

              A property-based condition that defines a property, operator, and one or more values for including or excluding objects from the job.

              • comparator (string) --

                The operator to use in the condition. Valid values for each supported property (key) are:

                • OBJECT_EXTENSION - EQ (equals) or NE (not equals)
                • OBJECT_KEY - STARTS_WITH
                • OBJECT_LAST_MODIFIED_DATE - Any operator except CONTAINS
                • OBJECT_SIZE - Any operator except CONTAINS
              • key (string) --

                The object property to use in the condition.

              • values (list) --

                An array that lists the values to use in the condition. If the value for the key property is OBJECT_EXTENSION or OBJECT_KEY, this array can specify multiple values and Amazon Macie uses OR logic to join the values. Otherwise, this array can specify only one value.

                Valid values for each supported property (key) are:

                • OBJECT_EXTENSION - A string that represents the file name extension of an object. For example: docx or pdf
                • OBJECT_KEY - A string that represents the key prefix (folder name or path) of an object. For example: logs or awslogs/eventlogs. This value applies a condition to objects whose keys (names) begin with the specified value.
                • OBJECT_LAST_MODIFIED_DATE - The date and time (in UTC and extended ISO 8601 format) when an object was created or last changed, whichever is latest. For example: 2020-09-28T14:31:13Z
                • OBJECT_SIZE - An integer that represents the storage size (in bytes) of an object.

                Macie doesn't support use of wildcard characters in these values. Also, string values are case sensitive.

                • (string) --
            • tagScopeTerm (dict) --

              A tag-based condition that defines the operator and tag keys or tag key and value pairs for including or excluding objects from the job.

              • comparator (string) --

                The operator to use in the condition. Valid values are EQ (equals) or NE (not equals).

              • key (string) --

                The object property to use in the condition. The only valid value is TAG.

              • tagValues (list) --

                The tag keys or tag key and value pairs to use in the condition. To specify only tag keys in a condition, specify the keys in this array and set the value for each associated tag value to an empty string.

                • (dict) --

                  Specifies a tag key or tag key and value pair to use in a tag-based condition that determines whether an S3 object is included or excluded from a classification job. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based conditions.

                  • key (string) --

                    The value for the tag key to use in the condition.

                  • value (string) --

                    The tag value, associated with the specified tag key (key), to use in the condition. To specify only a tag key for a condition, specify the tag key for the key property and set this value to an empty string.

              • target (string) --

                The type of object to apply the condition to.

      • includes (dict) --

        The property- and tag-based conditions that determine which objects to include in the analysis.

        • and (list) --

          An array of conditions, one for each property- or tag-based condition that determines which objects to include or exclude from the job. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

          • (dict) --

            Specifies a property- or tag-based condition that defines criteria for including or excluding S3 objects from a classification job. A JobScopeTerm object can contain only one simpleScopeTerm object or one tagScopeTerm object.

            • simpleScopeTerm (dict) --

              A property-based condition that defines a property, operator, and one or more values for including or excluding objects from the job.

              • comparator (string) --

                The operator to use in the condition. Valid values for each supported property (key) are:

                • OBJECT_EXTENSION - EQ (equals) or NE (not equals)
                • OBJECT_KEY - STARTS_WITH
                • OBJECT_LAST_MODIFIED_DATE - Any operator except CONTAINS
                • OBJECT_SIZE - Any operator except CONTAINS
              • key (string) --

                The object property to use in the condition.

              • values (list) --

                An array that lists the values to use in the condition. If the value for the key property is OBJECT_EXTENSION or OBJECT_KEY, this array can specify multiple values and Amazon Macie uses OR logic to join the values. Otherwise, this array can specify only one value.

                Valid values for each supported property (key) are:

                • OBJECT_EXTENSION - A string that represents the file name extension of an object. For example: docx or pdf
                • OBJECT_KEY - A string that represents the key prefix (folder name or path) of an object. For example: logs or awslogs/eventlogs. This value applies a condition to objects whose keys (names) begin with the specified value.
                • OBJECT_LAST_MODIFIED_DATE - The date and time (in UTC and extended ISO 8601 format) when an object was created or last changed, whichever is latest. For example: 2020-09-28T14:31:13Z
                • OBJECT_SIZE - An integer that represents the storage size (in bytes) of an object.

                Macie doesn't support use of wildcard characters in these values. Also, string values are case sensitive.

                • (string) --
            • tagScopeTerm (dict) --

              A tag-based condition that defines the operator and tag keys or tag key and value pairs for including or excluding objects from the job.

              • comparator (string) --

                The operator to use in the condition. Valid values are EQ (equals) or NE (not equals).

              • key (string) --

                The object property to use in the condition. The only valid value is TAG.

              • tagValues (list) --

                The tag keys or tag key and value pairs to use in the condition. To specify only tag keys in a condition, specify the keys in this array and set the value for each associated tag value to an empty string.

                • (dict) --

                  Specifies a tag key or tag key and value pair to use in a tag-based condition that determines whether an S3 object is included or excluded from a classification job. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based conditions.

                  • key (string) --

                    The value for the tag key to use in the condition.

                  • value (string) --

                    The tag value, associated with the specified tag key (key), to use in the condition. To specify only a tag key for a condition, specify the tag key for the key property and set this value to an empty string.

              • target (string) --

                The type of object to apply the condition to.

    • bucketCriteria (dict) --

      The property- and tag-based conditions that determine which S3 buckets to include or exclude from the analysis. Each time the job runs, the job uses these criteria to determine which buckets contain objects to analyze. A job's definition can contain a bucketCriteria object or a bucketDefinitions array, not both.

      • excludes (dict) --

        The property- and tag-based conditions that determine which buckets to exclude from the job.

        • and (list) --

          An array of conditions, one for each condition that determines which buckets to include or exclude from the job. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

          • (dict) --

            Specifies a property- or tag-based condition that defines criteria for including or excluding S3 buckets from a classification job.

            • simpleCriterion (dict) --

              A property-based condition that defines a property, operator, and one or more values for including or excluding buckets from the job.

              • comparator (string) --

                The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

              • key (string) --

                The property to use in the condition.

              • values (list) --

                An array that lists one or more values to use in the condition. If you specify multiple values, Amazon Macie uses OR logic to join the values. Valid values for each supported property (key) are:

                • ACCOUNT_ID - A string that represents the unique identifier for the Amazon Web Services account that owns the bucket.
                • S3_BUCKET_EFFECTIVE_PERMISSION - A string that represents an enumerated value that Macie defines for the BucketPublicAccess.effectivePermission property of a bucket.
                • S3_BUCKET_NAME - A string that represents the name of a bucket.
                • S3_BUCKET_SHARED_ACCESS - A string that represents an enumerated value that Macie defines for the BucketMetadata.sharedAccess property of a bucket.

                Values are case sensitive. Also, Macie doesn't support use of partial values or wildcard characters in these values.

                • (string) --
            • tagCriterion (dict) --

              A tag-based condition that defines an operator and tag keys, tag values, or tag key and value pairs for including or excluding buckets from the job.

              • comparator (string) --

                The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

              • tagValues (list) --

                The tag keys, tag values, or tag key and value pairs to use in the condition.

                • (dict) --

                  Specifies a tag key, a tag value, or a tag key and value (as a pair) to use in a tag-based condition that determines whether an S3 bucket is included or excluded from a classification job. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based conditions.

                  • key (string) --

                    The value for the tag key to use in the condition.

                  • value (string) --

                    The tag value to use in the condition.

      • includes (dict) --

        The property- and tag-based conditions that determine which buckets to include in the job.

        • and (list) --

          An array of conditions, one for each condition that determines which buckets to include or exclude from the job. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

          • (dict) --

            Specifies a property- or tag-based condition that defines criteria for including or excluding S3 buckets from a classification job.

            • simpleCriterion (dict) --

              A property-based condition that defines a property, operator, and one or more values for including or excluding buckets from the job.

              • comparator (string) --

                The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

              • key (string) --

                The property to use in the condition.

              • values (list) --

                An array that lists one or more values to use in the condition. If you specify multiple values, Amazon Macie uses OR logic to join the values. Valid values for each supported property (key) are:

                • ACCOUNT_ID - A string that represents the unique identifier for the Amazon Web Services account that owns the bucket.
                • S3_BUCKET_EFFECTIVE_PERMISSION - A string that represents an enumerated value that Macie defines for the BucketPublicAccess.effectivePermission property of a bucket.
                • S3_BUCKET_NAME - A string that represents the name of a bucket.
                • S3_BUCKET_SHARED_ACCESS - A string that represents an enumerated value that Macie defines for the BucketMetadata.sharedAccess property of a bucket.

                Values are case sensitive. Also, Macie doesn't support use of partial values or wildcard characters in these values.

                • (string) --
            • tagCriterion (dict) --

              A tag-based condition that defines an operator and tag keys, tag values, or tag key and value pairs for including or excluding buckets from the job.

              • comparator (string) --

                The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

              • tagValues (list) --

                The tag keys, tag values, or tag key and value pairs to use in the condition.

                • (dict) --

                  Specifies a tag key, a tag value, or a tag key and value (as a pair) to use in a tag-based condition that determines whether an S3 bucket is included or excluded from a classification job. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based conditions.

                  • key (string) --

                    The value for the tag key to use in the condition.

                  • value (string) --

                    The tag value to use in the condition.

  • samplingPercentage (integer) -- The sampling depth, as a percentage, for the job to apply when processing objects. This value determines the percentage of eligible objects that the job analyzes. If this value is less than 100, Amazon Macie selects the objects to analyze at random, up to the specified percentage, and analyzes all the data in those objects.
  • scheduleFrequency (dict) --

    The recurrence pattern for running the job. To run the job only once, don't specify a value for this property and set the value for the jobType property to ONE_TIME.

    • dailySchedule (dict) --

      Specifies a daily recurrence pattern for running the job.

    • monthlySchedule (dict) --

      Specifies a monthly recurrence pattern for running the job.

      • dayOfMonth (integer) --

        The numeric day of the month when Amazon Macie runs the job. This value can be an integer from 1 through 31.

        If this value exceeds the number of days in a certain month, Macie doesn't run the job that month. Macie runs the job only during months that have the specified day. For example, if this value is 31 and a month has only 30 days, Macie doesn't run the job that month. To run the job every month, specify a value that's less than 29.

    • weeklySchedule (dict) --

      Specifies a weekly recurrence pattern for running the job.

      • dayOfWeek (string) --

        The day of the week when Amazon Macie runs the job.

  • tags (dict) --

    A map of key-value pairs that specifies the tags to associate with the job.

    A job can have a maximum of 50 tags. Each tag consists of a tag key and an associated tag value. The maximum length of a tag key is 128 characters. The maximum length of a tag value is 256 characters.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'jobArn': 'string',
    'jobId': 'string'
}

Response Structure

  • (dict) --

    The request succeeded. The specified job was created.

    • jobArn (string) --

      The Amazon Resource Name (ARN) of the job.

    • jobId (string) --

      The unique identifier for the job.

Exceptions

create_custom_data_identifier(**kwargs)

Creates and defines the criteria and other settings for a custom data identifier.

See also: AWS API Documentation

Request Syntax

response = client.create_custom_data_identifier(
    clientToken='string',
    description='string',
    ignoreWords=[
        'string',
    ],
    keywords=[
        'string',
    ],
    maximumMatchDistance=123,
    name='string',
    regex='string',
    tags={
        'string': 'string'
    }
)
Parameters
  • clientToken (string) --

    A unique, case-sensitive token that you provide to ensure the idempotency of the request.

    This field is autopopulated if not provided.

  • description (string) --

    A custom description of the custom data identifier. The description can contain as many as 512 characters.

    We strongly recommend that you avoid including any sensitive data in the description of a custom data identifier. Other users of your account might be able to see the identifier's description, depending on the actions that they're allowed to perform in Amazon Macie.

  • ignoreWords (list) --

    An array that lists specific character sequences (ignore words) to exclude from the results. If the text matched by the regular expression is the same as any string in this array, Amazon Macie ignores it. The array can contain as many as 10 ignore words. Each ignore word can contain 4-90 UTF-8 characters. Ignore words are case sensitive.

    • (string) --
  • keywords (list) --

    An array that lists specific character sequences (keywords), one of which must be within proximity (maximumMatchDistance) of the regular expression to match. The array can contain as many as 50 keywords. Each keyword can contain 3-90 UTF-8 characters. Keywords aren't case sensitive.

    • (string) --
  • maximumMatchDistance (integer) -- The maximum number of characters that can exist between text that matches the regex pattern and the character sequences specified by the keywords array. Amazon Macie includes or excludes a result based on the proximity of a keyword to text that matches the regex pattern. The distance can be 1-300 characters. The default value is 50.
  • name (string) --

    A custom name for the custom data identifier. The name can contain as many as 128 characters.

    We strongly recommend that you avoid including any sensitive data in the name of a custom data identifier. Other users of your account might be able to see the identifier's name, depending on the actions that they're allowed to perform in Amazon Macie.

  • regex (string) -- The regular expression (regex ) that defines the pattern to match. The expression can contain as many as 512 characters.
  • tags (dict) --

    A map of key-value pairs that specifies the tags to associate with the custom data identifier.

    A custom data identifier can have a maximum of 50 tags. Each tag consists of a tag key and an associated tag value. The maximum length of a tag key is 128 characters. The maximum length of a tag value is 256 characters.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'customDataIdentifierId': 'string'
}

Response Structure

  • (dict) --

    The request succeeded. The specified custom data identifier was created.

    • customDataIdentifierId (string) --

      The unique identifier for the custom data identifier that was created.

Exceptions

create_findings_filter(**kwargs)

Creates and defines the criteria and other settings for a findings filter.

See also: AWS API Documentation

Request Syntax

response = client.create_findings_filter(
    action='ARCHIVE'|'NOOP',
    clientToken='string',
    description='string',
    findingCriteria={
        'criterion': {
            'string': {
                'eq': [
                    'string',
                ],
                'eqExactMatch': [
                    'string',
                ],
                'gt': 123,
                'gte': 123,
                'lt': 123,
                'lte': 123,
                'neq': [
                    'string',
                ]
            }
        }
    },
    name='string',
    position=123,
    tags={
        'string': 'string'
    }
)
Parameters
  • action (string) --

    [REQUIRED]

    The action to perform on findings that meet the filter criteria (findingCriteria). Valid values are: ARCHIVE, suppress (automatically archive) the findings; and, NOOP, don't perform any action on the findings.

  • clientToken (string) --

    A unique, case-sensitive token that you provide to ensure the idempotency of the request.

    This field is autopopulated if not provided.

  • description (string) --

    A custom description of the filter. The description can contain as many as 512 characters.

    We strongly recommend that you avoid including any sensitive data in the description of a filter. Other users of your account might be able to see the filter's description, depending on the actions that they're allowed to perform in Amazon Macie.

  • findingCriteria (dict) --

    [REQUIRED]

    The criteria to use to filter findings.

    • criterion (dict) --

      A condition that specifies the property, operator, and one or more values to use to filter the results.

      • (string) --
        • (dict) --

          Specifies the operator to use in a property-based condition that filters the results of a query for findings. For detailed information and examples of each operator, see Fundamentals of filtering findings in the Amazon Macie User Guide .

          • eq (list) --

            The value for the property matches (equals) the specified value. If you specify multiple values, Macie uses OR logic to join the values.

            • (string) --
          • eqExactMatch (list) --

            The value for the property exclusively matches (equals an exact match for) all the specified values. If you specify multiple values, Amazon Macie uses AND logic to join the values.

            You can use this operator with the following properties: customDataIdentifiers.detections.arn, customDataIdentifiers.detections.name, resourcesAffected.s3Bucket.tags.key, resourcesAffected.s3Bucket.tags.value, resourcesAffected.s3Object.tags.key, resourcesAffected.s3Object.tags.value, sensitiveData.category, and sensitiveData.detections.type.

            • (string) --
          • gt (integer) --

            The value for the property is greater than the specified value.

          • gte (integer) --

            The value for the property is greater than or equal to the specified value.

          • lt (integer) --

            The value for the property is less than the specified value.

          • lte (integer) --

            The value for the property is less than or equal to the specified value.

          • neq (list) --

            The value for the property doesn't match (doesn't equal) the specified value. If you specify multiple values, Macie uses OR logic to join the values.

            • (string) --
  • name (string) --

    [REQUIRED]

    A custom name for the filter. The name must contain at least 3 characters and can contain as many as 64 characters.

    We strongly recommend that you avoid including any sensitive data in the name of a filter. Other users of your account might be able to see the filter's name, depending on the actions that they're allowed to perform in Amazon Macie.

  • position (integer) -- The position of the filter in the list of saved filters on the Amazon Macie console. This value also determines the order in which the filter is applied to findings, relative to other filters that are also applied to the findings.
  • tags (dict) --

    A map of key-value pairs that specifies the tags to associate with the filter.

    A findings filter can have a maximum of 50 tags. Each tag consists of a tag key and an associated tag value. The maximum length of a tag key is 128 characters. The maximum length of a tag value is 256 characters.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'arn': 'string',
    'id': 'string'
}

Response Structure

  • (dict) --

    • arn (string) --

      The Amazon Resource Name (ARN) of the filter that was created.

    • id (string) --

      The unique identifier for the filter that was created.

Exceptions

create_invitations(**kwargs)

Sends an Amazon Macie membership invitation to one or more accounts.

See also: AWS API Documentation

Request Syntax

response = client.create_invitations(
    accountIds=[
        'string',
    ],
    disableEmailNotification=True|False,
    message='string'
)
Parameters
  • accountIds (list) --

    [REQUIRED]

    An array that lists Amazon Web Services account IDs, one for each account to send the invitation to.

    • (string) --
  • disableEmailNotification (boolean) -- Specifies whether to send an email notification to the root user of each account that the invitation will be sent to. This notification is in addition to an alert that the root user receives in Personal Health Dashboard. To send an email notification to the root user of each account, set this value to true.
  • message (string) -- A custom message to include in the invitation. Amazon Macie adds this message to the standard content that it sends for an invitation.
Return type

dict

Returns

Response Syntax

{
    'unprocessedAccounts': [
        {
            'accountId': 'string',
            'errorCode': 'ClientError'|'InternalError',
            'errorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    The request succeeded. Processing might not be complete.

    • unprocessedAccounts (list) --

      An array of objects, one for each account whose invitation hasn't been processed. Each object identifies the account and explains why the invitation hasn't been processed for the account.

      • (dict) --

        Provides information about an account-related request that hasn't been processed.

        • accountId (string) --

          The Amazon Web Services account ID for the account that the request applies to.

        • errorCode (string) --

          The source of the issue or delay in processing the request.

        • errorMessage (string) --

          The reason why the request hasn't been processed.

Exceptions

create_member(**kwargs)

Associates an account with an Amazon Macie administrator account.

See also: AWS API Documentation

Request Syntax

response = client.create_member(
    account={
        'accountId': 'string',
        'email': 'string'
    },
    tags={
        'string': 'string'
    }
)
Parameters
  • account (dict) --

    [REQUIRED]

    The details of the account to associate with the administrator account.

    • accountId (string) -- [REQUIRED]

      The Amazon Web Services account ID for the account.

    • email (string) -- [REQUIRED]

      The email address for the account.

  • tags (dict) --

    A map of key-value pairs that specifies the tags to associate with the account in Amazon Macie.

    An account can have a maximum of 50 tags. Each tag consists of a tag key and an associated tag value. The maximum length of a tag key is 128 characters. The maximum length of a tag value is 256 characters.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'arn': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • arn (string) --

      The Amazon Resource Name (ARN) of the account that was associated with the administrator account.

Exceptions

create_sample_findings(**kwargs)

Creates sample findings.

See also: AWS API Documentation

Request Syntax

response = client.create_sample_findings(
    findingTypes=[
        'SensitiveData:S3Object/Multiple'|'SensitiveData:S3Object/Financial'|'SensitiveData:S3Object/Personal'|'SensitiveData:S3Object/Credentials'|'SensitiveData:S3Object/CustomIdentifier'|'Policy:IAMUser/S3BucketPublic'|'Policy:IAMUser/S3BucketSharedExternally'|'Policy:IAMUser/S3BucketReplicatedExternally'|'Policy:IAMUser/S3BucketEncryptionDisabled'|'Policy:IAMUser/S3BlockPublicAccessDisabled',
    ]
)
Parameters
findingTypes (list) --

An array that lists one or more types of findings to include in the set of sample findings. Currently, the only supported value is Policy:IAMUser/S3BucketEncryptionDisabled.

Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --

    The request succeeded and there isn't any content to include in the body of the response (No Content).

Exceptions

decline_invitations(**kwargs)

Declines Amazon Macie membership invitations that were received from specific accounts.

See also: AWS API Documentation

Request Syntax

response = client.decline_invitations(
    accountIds=[
        'string',
    ]
)
Parameters
accountIds (list) --

[REQUIRED]

An array that lists Amazon Web Services account IDs, one for each account that sent an invitation to decline.

  • (string) --
Return type
dict
Returns
Response Syntax
{
    'unprocessedAccounts': [
        {
            'accountId': 'string',
            'errorCode': 'ClientError'|'InternalError',
            'errorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    The request succeeded. Processing might not be complete.

    • unprocessedAccounts (list) --

      An array of objects, one for each account whose invitation hasn't been declined. Each object identifies the account and explains why the request hasn't been processed for that account.

      • (dict) --

        Provides information about an account-related request that hasn't been processed.

        • accountId (string) --

          The Amazon Web Services account ID for the account that the request applies to.

        • errorCode (string) --

          The source of the issue or delay in processing the request.

        • errorMessage (string) --

          The reason why the request hasn't been processed.

Exceptions

delete_custom_data_identifier(**kwargs)

Soft deletes a custom data identifier.

See also: AWS API Documentation

Request Syntax

response = client.delete_custom_data_identifier(
    id='string'
)
Parameters
id (string) --

[REQUIRED]

The unique identifier for the Amazon Macie resource or account that the request applies to.

Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --

    The request succeeded. The specified custom data identifier was deleted and there isn't any content to include in the body of the response (No Content).

Exceptions

delete_findings_filter(**kwargs)

Deletes a findings filter.

See also: AWS API Documentation

Request Syntax

response = client.delete_findings_filter(
    id='string'
)
Parameters
id (string) --

[REQUIRED]

The unique identifier for the Amazon Macie resource or account that the request applies to.

Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --

    The request succeeded. The specified findings filter was deleted and there isn't any content to include in the body of the response (No Content).

Exceptions

delete_invitations(**kwargs)

Deletes Amazon Macie membership invitations that were received from specific accounts.

See also: AWS API Documentation

Request Syntax

response = client.delete_invitations(
    accountIds=[
        'string',
    ]
)
Parameters
accountIds (list) --

[REQUIRED]

An array that lists Amazon Web Services account IDs, one for each account that sent an invitation to delete.

  • (string) --
Return type
dict
Returns
Response Syntax
{
    'unprocessedAccounts': [
        {
            'accountId': 'string',
            'errorCode': 'ClientError'|'InternalError',
            'errorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    The request succeeded. Processing might not be complete.

    • unprocessedAccounts (list) --

      An array of objects, one for each account whose invitation hasn't been deleted. Each object identifies the account and explains why the request hasn't been processed for that account.

      • (dict) --

        Provides information about an account-related request that hasn't been processed.

        • accountId (string) --

          The Amazon Web Services account ID for the account that the request applies to.

        • errorCode (string) --

          The source of the issue or delay in processing the request.

        • errorMessage (string) --

          The reason why the request hasn't been processed.

Exceptions

delete_member(**kwargs)

Deletes the association between an Amazon Macie administrator account and an account.

See also: AWS API Documentation

Request Syntax

response = client.delete_member(
    id='string'
)
Parameters
id (string) --

[REQUIRED]

The unique identifier for the Amazon Macie resource or account that the request applies to.

Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --

    The request succeeded. The association was deleted and there isn't any content to include in the body of the response (No Content).

Exceptions

describe_buckets(**kwargs)

Retrieves (queries) statistical data and other information about one or more S3 buckets that Amazon Macie monitors and analyzes.

See also: AWS API Documentation

Request Syntax

response = client.describe_buckets(
    criteria={
        'string': {
            'eq': [
                'string',
            ],
            'gt': 123,
            'gte': 123,
            'lt': 123,
            'lte': 123,
            'neq': [
                'string',
            ],
            'prefix': 'string'
        }
    },
    maxResults=123,
    nextToken='string',
    sortCriteria={
        'attributeName': 'string',
        'orderBy': 'ASC'|'DESC'
    }
)
Parameters
  • criteria (dict) --

    The criteria to use to filter the query results.

    • (string) --
      • (dict) --

        Specifies the operator to use in a property-based condition that filters the results of a query for information about S3 buckets.

        • eq (list) --

          The value for the property matches (equals) the specified value. If you specify multiple values, Amazon Macie uses OR logic to join the values.

          • (string) --
        • gt (integer) --

          The value for the property is greater than the specified value.

        • gte (integer) --

          The value for the property is greater than or equal to the specified value.

        • lt (integer) --

          The value for the property is less than the specified value.

        • lte (integer) --

          The value for the property is less than or equal to the specified value.

        • neq (list) --

          The value for the property doesn't match (doesn't equal) the specified value. If you specify multiple values, Amazon Macie uses OR logic to join the values.

          • (string) --
        • prefix (string) --

          The name of the bucket begins with the specified value.

  • maxResults (integer) -- The maximum number of items to include in each page of the response. The default value is 50.
  • nextToken (string) -- The nextToken string that specifies which page of results to return in a paginated response.
  • sortCriteria (dict) --

    The criteria to use to sort the query results.

    • attributeName (string) --

      The name of the bucket property to sort the results by. This value can be one of the following properties that Amazon Macie defines as bucket metadata: accountId, bucketName, classifiableObjectCount, classifiableSizeInBytes, objectCount, or sizeInBytes.

    • orderBy (string) --

      The sort order to apply to the results, based on the value specified by the attributeName property. Valid values are: ASC, sort the results in ascending order; and, DESC, sort the results in descending order.

Return type

dict

Returns

Response Syntax

{
    'buckets': [
        {
            'accountId': 'string',
            'allowsUnencryptedObjectUploads': 'TRUE'|'FALSE'|'UNKNOWN',
            'bucketArn': 'string',
            'bucketCreatedAt': datetime(2015, 1, 1),
            'bucketName': 'string',
            'classifiableObjectCount': 123,
            'classifiableSizeInBytes': 123,
            'errorCode': 'ACCESS_DENIED',
            'errorMessage': 'string',
            'jobDetails': {
                'isDefinedInJob': 'TRUE'|'FALSE'|'UNKNOWN',
                'isMonitoredByJob': 'TRUE'|'FALSE'|'UNKNOWN',
                'lastJobId': 'string',
                'lastJobRunTime': datetime(2015, 1, 1)
            },
            'lastUpdated': datetime(2015, 1, 1),
            'objectCount': 123,
            'objectCountByEncryptionType': {
                'customerManaged': 123,
                'kmsManaged': 123,
                's3Managed': 123,
                'unencrypted': 123,
                'unknown': 123
            },
            'publicAccess': {
                'effectivePermission': 'PUBLIC'|'NOT_PUBLIC'|'UNKNOWN',
                'permissionConfiguration': {
                    'accountLevelPermissions': {
                        'blockPublicAccess': {
                            'blockPublicAcls': True|False,
                            'blockPublicPolicy': True|False,
                            'ignorePublicAcls': True|False,
                            'restrictPublicBuckets': True|False
                        }
                    },
                    'bucketLevelPermissions': {
                        'accessControlList': {
                            'allowsPublicReadAccess': True|False,
                            'allowsPublicWriteAccess': True|False
                        },
                        'blockPublicAccess': {
                            'blockPublicAcls': True|False,
                            'blockPublicPolicy': True|False,
                            'ignorePublicAcls': True|False,
                            'restrictPublicBuckets': True|False
                        },
                        'bucketPolicy': {
                            'allowsPublicReadAccess': True|False,
                            'allowsPublicWriteAccess': True|False
                        }
                    }
                }
            },
            'region': 'string',
            'replicationDetails': {
                'replicated': True|False,
                'replicatedExternally': True|False,
                'replicationAccounts': [
                    'string',
                ]
            },
            'serverSideEncryption': {
                'kmsMasterKeyId': 'string',
                'type': 'NONE'|'AES256'|'aws:kms'
            },
            'sharedAccess': 'EXTERNAL'|'INTERNAL'|'NOT_SHARED'|'UNKNOWN',
            'sizeInBytes': 123,
            'sizeInBytesCompressed': 123,
            'tags': [
                {
                    'key': 'string',
                    'value': 'string'
                },
            ],
            'unclassifiableObjectCount': {
                'fileType': 123,
                'storageClass': 123,
                'total': 123
            },
            'unclassifiableObjectSizeInBytes': {
                'fileType': 123,
                'storageClass': 123,
                'total': 123
            },
            'versioning': True|False
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • buckets (list) --

      An array of objects, one for each bucket that meets the filter criteria specified in the request.

      • (dict) --

        Provides statistical data and other information about an S3 bucket that Amazon Macie monitors and analyzes for your account. If an error occurs when Macie attempts to retrieve and process information about the bucket or the bucket's objects, the value for most of these properties is null. Exceptions are accountId, bucketArn, bucketCreatedAt, bucketName, lastUpdated, and region. To identify the cause of the error, refer to the errorCode and errorMessage values.

        • accountId (string) --

          The unique identifier for the Amazon Web Services account that owns the bucket.

        • allowsUnencryptedObjectUploads (string) --

          Specifies whether the bucket policy for the bucket requires server-side encryption of objects when objects are uploaded to the bucket. Possible values are:

          • FALSE - The bucket policy requires server-side encryption of new objects. PutObject requests must include the x-amz-server-side-encryption header and the value for that header must be AES256 or aws:kms.
          • TRUE - The bucket doesn't have a bucket policy or it has a bucket policy that doesn't require server-side encryption of new objects. If a bucket policy exists, it doesn't require PutObject requests to include the x-amz-server-side-encryption header and it doesn't require the value for that header to be AES256 or aws:kms.
          • UNKNOWN - Amazon Macie can't determine whether the bucket policy requires server-side encryption of new objects.
        • bucketArn (string) --

          The Amazon Resource Name (ARN) of the bucket.

        • bucketCreatedAt (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when the bucket was created.

        • bucketName (string) --

          The name of the bucket.

        • classifiableObjectCount (integer) --

          The total number of objects that Amazon Macie can analyze in the bucket. These objects use a supported storage class and have a file name extension for a supported file or storage format.

        • classifiableSizeInBytes (integer) --

          The total storage size, in bytes, of the objects that Amazon Macie can analyze in the bucket. These objects use a supported storage class and have a file name extension for a supported file or storage format.

          If versioning is enabled for the bucket, Macie calculates this value based on the size of the latest version of each applicable object in the bucket. This value doesn't reflect the storage size of all versions of each applicable object in the bucket.

        • errorCode (string) --

          Specifies the error code for an error that prevented Amazon Macie from retrieving and processing information about the bucket and the bucket's objects. If this value is ACCESS_DENIED, Macie doesn't have permission to retrieve the information. For example, the bucket has a restrictive bucket policy and Amazon S3 denied the request. If this value is null, Macie was able to retrieve and process the information.

        • errorMessage (string) --

          A brief description of the error (errorCode) that prevented Amazon Macie from retrieving and processing information about the bucket and the bucket's objects. This value is null if Macie was able to retrieve and process the information.

        • jobDetails (dict) --

          Specifies whether any one-time or recurring classification jobs are configured to analyze data in the bucket, and, if so, the details of the job that ran most recently.

          • isDefinedInJob (string) --

            Specifies whether any one-time or recurring jobs are configured to analyze data in the bucket. Possible values are:

            • TRUE - The bucket is explicitly included in the bucket definition (S3BucketDefinitionForJob) for one or more jobs and at least one of those jobs has a status other than CANCELLED. Or the bucket matched the bucket criteria (S3BucketCriteriaForJob) for at least one job that previously ran.
            • FALSE - The bucket isn't explicitly included in the bucket definition (S3BucketDefinitionForJob) for any jobs, all the jobs that explicitly include the bucket in their bucket definitions have a status of CANCELLED, or the bucket didn't match the bucket criteria (S3BucketCriteriaForJob) for any jobs that previously ran.
            • UNKNOWN - An exception occurred when Amazon Macie attempted to retrieve job data for the bucket.
          • isMonitoredByJob (string) --

            Specifies whether any recurring jobs are configured to analyze data in the bucket. Possible values are:

            • TRUE - The bucket is explicitly included in the bucket definition (S3BucketDefinitionForJob) for one or more recurring jobs or the bucket matches the bucket criteria (S3BucketCriteriaForJob) for one or more recurring jobs. At least one of those jobs has a status other than CANCELLED.
            • FALSE - The bucket isn't explicitly included in the bucket definition (S3BucketDefinitionForJob) for any recurring jobs, the bucket doesn't match the bucket criteria (S3BucketCriteriaForJob) for any recurring jobs, or all the recurring jobs that are configured to analyze data in the bucket have a status of CANCELLED.
            • UNKNOWN - An exception occurred when Amazon Macie attempted to retrieve job data for the bucket.
          • lastJobId (string) --

            The unique identifier for the job that ran most recently and is configured to analyze data in the bucket, either the latest run of a recurring job or the only run of a one-time job.

            This value is typically null if the value for the isDefinedInJob property is FALSE or UNKNOWN.

          • lastJobRunTime (datetime) --

            The date and time, in UTC and extended ISO 8601 format, when the job (lastJobId) started. If the job is a recurring job, this value indicates when the most recent run started.

            This value is typically null if the value for the isDefinedInJob property is FALSE or UNKNOWN.

        • lastUpdated (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when Amazon Macie most recently retrieved both bucket and object metadata from Amazon S3 for the bucket.

        • objectCount (integer) --

          The total number of objects in the bucket.

        • objectCountByEncryptionType (dict) --

          The total number of objects that are in the bucket, grouped by server-side encryption type. This includes a grouping that reports the total number of objects that aren't encrypted or use client-side encryption.

          • customerManaged (integer) --

            The total number of objects that are encrypted with a customer-provided key. The objects use customer-provided server-side encryption (SSE-C).

          • kmsManaged (integer) --

            The total number of objects that are encrypted with an KMS key, either an Amazon Web Services managed key or a customer managed key. The objects use KMS encryption (SSE-KMS).

          • s3Managed (integer) --

            The total number of objects that are encrypted with an Amazon S3 managed key. The objects use Amazon S3 managed encryption (SSE-S3).

          • unencrypted (integer) --

            The total number of objects that aren't encrypted or use client-side encryption.

          • unknown (integer) --

            The total number of objects that Amazon Macie doesn't have current encryption metadata for. Macie can't provide current data about the encryption settings for these objects.

        • publicAccess (dict) --

          Specifies whether the bucket is publicly accessible due to the combination of permissions settings that apply to the bucket, and provides information about those settings.

          • effectivePermission (string) --

            Specifies whether the bucket is publicly accessible due to the combination of permissions settings that apply to the bucket. Possible values are:

            • NOT_PUBLIC - The bucket isn't publicly accessible.
            • PUBLIC - The bucket is publicly accessible.
            • UNKNOWN - Amazon Macie can't determine whether the bucket is publicly accessible.
          • permissionConfiguration (dict) --

            The account-level and bucket-level permissions settings for the bucket.

            • accountLevelPermissions (dict) --

              The account-level permissions settings that apply to the bucket.

              • blockPublicAccess (dict) --

                The block public access settings for the Amazon Web Services account that owns the bucket.

                • blockPublicAcls (boolean) --

                  Specifies whether Amazon S3 blocks public access control lists (ACLs) for the bucket and objects in the bucket.

                • blockPublicPolicy (boolean) --

                  Specifies whether Amazon S3 blocks public bucket policies for the bucket.

                • ignorePublicAcls (boolean) --

                  Specifies whether Amazon S3 ignores public ACLs for the bucket and objects in the bucket.

                • restrictPublicBuckets (boolean) --

                  Specifies whether Amazon S3 restricts public bucket policies for the bucket.

            • bucketLevelPermissions (dict) --

              The bucket-level permissions settings for the bucket.

              • accessControlList (dict) --

                The permissions settings of the access control list (ACL) for the bucket. This value is null if an ACL hasn't been defined for the bucket.

                • allowsPublicReadAccess (boolean) --

                  Specifies whether the ACL grants the general public with read access permissions for the bucket.

                • allowsPublicWriteAccess (boolean) --

                  Specifies whether the ACL grants the general public with write access permissions for the bucket.

              • blockPublicAccess (dict) --

                The block public access settings for the bucket.

                • blockPublicAcls (boolean) --

                  Specifies whether Amazon S3 blocks public access control lists (ACLs) for the bucket and objects in the bucket.

                • blockPublicPolicy (boolean) --

                  Specifies whether Amazon S3 blocks public bucket policies for the bucket.

                • ignorePublicAcls (boolean) --

                  Specifies whether Amazon S3 ignores public ACLs for the bucket and objects in the bucket.

                • restrictPublicBuckets (boolean) --

                  Specifies whether Amazon S3 restricts public bucket policies for the bucket.

              • bucketPolicy (dict) --

                The permissions settings of the bucket policy for the bucket. This value is null if a bucket policy hasn't been defined for the bucket.

                • allowsPublicReadAccess (boolean) --

                  Specifies whether the bucket policy allows the general public to have read access to the bucket.

                • allowsPublicWriteAccess (boolean) --

                  Specifies whether the bucket policy allows the general public to have write access to the bucket.

        • region (string) --

          The Amazon Web Services Region that hosts the bucket.

        • replicationDetails (dict) --

          Specifies whether the bucket is configured to replicate one or more objects to buckets for other Amazon Web Services accounts and, if so, which accounts.

          • replicated (boolean) --

            Specifies whether the bucket is configured to replicate one or more objects to any destination.

          • replicatedExternally (boolean) --

            Specifies whether the bucket is configured to replicate one or more objects to an Amazon Web Services account that isn't part of the same Amazon Macie organization.

          • replicationAccounts (list) --

            An array of Amazon Web Services account IDs, one for each Amazon Web Services account that the bucket is configured to replicate one or more objects to.

            • (string) --
        • serverSideEncryption (dict) --

          Specifies whether the bucket encrypts new objects by default and, if so, the type of server-side encryption that's used.

          • kmsMasterKeyId (string) --

            The Amazon Resource Name (ARN) or unique identifier (key ID) for the KMS key that's used by default to encrypt objects that are added to the bucket. This value is null if the bucket uses an Amazon S3 managed key to encrypt new objects or the bucket doesn't encrypt new objects by default.

          • type (string) --

            The type of server-side encryption that's used by default when storing new objects in the bucket. Possible values are:

            • AES256 - New objects are encrypted with an Amazon S3 managed key. They use SSE-S3 encryption.
            • aws:kms - New objects are encrypted with an KMS key (kmsMasterKeyId), either an Amazon Web Services managed key or a customer managed key. They use SSE-KMS encryption.
            • NONE - New objects aren't encrypted by default. Default encryption is disabled for the bucket.
        • sharedAccess (string) --

          Specifies whether the bucket is shared with another Amazon Web Services account. Possible values are:

          • EXTERNAL - The bucket is shared with an Amazon Web Services account that isn't part of the same Amazon Macie organization.
          • INTERNAL - The bucket is shared with an Amazon Web Services account that's part of the same Amazon Macie organization.
          • NOT_SHARED - The bucket isn't shared with other Amazon Web Services accounts.
          • UNKNOWN - Amazon Macie wasn't able to evaluate the shared access settings for the bucket.
        • sizeInBytes (integer) --

          The total storage size, in bytes, of the bucket.

          If versioning is enabled for the bucket, Amazon Macie calculates this value based on the size of the latest version of each object in the bucket. This value doesn't reflect the storage size of all versions of each object in the bucket.

        • sizeInBytesCompressed (integer) --

          The total storage size, in bytes, of the objects that are compressed (.gz, .gzip, .zip) files in the bucket.

          If versioning is enabled for the bucket, Amazon Macie calculates this value based on the size of the latest version of each applicable object in the bucket. This value doesn't reflect the storage size of all versions of each applicable object in the bucket.

        • tags (list) --

          An array that specifies the tags (keys and values) that are associated with the bucket.

          • (dict) --

            Provides information about the tags that are associated with an S3 bucket or object. Each tag consists of a required tag key and an associated tag value.

            • key (string) --

              One part of a key-value pair that comprises a tag. A tag key is a general label that acts as a category for more specific tag values.

            • value (string) --

              One part of a key-value pair that comprises a tag. A tag value acts as a descriptor for a tag key. A tag value can be an empty string.

        • unclassifiableObjectCount (dict) --

          The total number of objects that Amazon Macie can't analyze in the bucket. These objects don't use a supported storage class or don't have a file name extension for a supported file or storage format.

          • fileType (integer) --

            The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects don't have a file name extension for a supported file or storage format.

          • storageClass (integer) --

            The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class.

          • total (integer) --

            The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class or don't have a file name extension for a supported file or storage format.

        • unclassifiableObjectSizeInBytes (dict) --

          The total storage size, in bytes, of the objects that Amazon Macie can't analyze in the bucket. These objects don't use a supported storage class or don't have a file name extension for a supported file or storage format.

          • fileType (integer) --

            The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects don't have a file name extension for a supported file or storage format.

          • storageClass (integer) --

            The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class.

          • total (integer) --

            The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class or don't have a file name extension for a supported file or storage format.

        • versioning (boolean) --

          Specifies whether versioning is enabled for the bucket.

    • nextToken (string) --

      The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.

Exceptions

describe_classification_job(**kwargs)

Retrieves the status and settings for a classification job.

See also: AWS API Documentation

Request Syntax

response = client.describe_classification_job(
    jobId='string'
)
Parameters
jobId (string) --

[REQUIRED]

The unique identifier for the classification job.

Return type
dict
Returns
Response Syntax
{
    'clientToken': 'string',
    'createdAt': datetime(2015, 1, 1),
    'customDataIdentifierIds': [
        'string',
    ],
    'description': 'string',
    'initialRun': True|False,
    'jobArn': 'string',
    'jobId': 'string',
    'jobStatus': 'RUNNING'|'PAUSED'|'CANCELLED'|'COMPLETE'|'IDLE'|'USER_PAUSED',
    'jobType': 'ONE_TIME'|'SCHEDULED',
    'lastRunErrorStatus': {
        'code': 'NONE'|'ERROR'
    },
    'lastRunTime': datetime(2015, 1, 1),
    'managedDataIdentifierIds': [
        'string',
    ],
    'managedDataIdentifierSelector': 'ALL'|'EXCLUDE'|'INCLUDE'|'NONE',
    'name': 'string',
    's3JobDefinition': {
        'bucketDefinitions': [
            {
                'accountId': 'string',
                'buckets': [
                    'string',
                ]
            },
        ],
        'scoping': {
            'excludes': {
                'and': [
                    {
                        'simpleScopeTerm': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'key': 'OBJECT_EXTENSION'|'OBJECT_LAST_MODIFIED_DATE'|'OBJECT_SIZE'|'OBJECT_KEY',
                            'values': [
                                'string',
                            ]
                        },
                        'tagScopeTerm': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'key': 'string',
                            'tagValues': [
                                {
                                    'key': 'string',
                                    'value': 'string'
                                },
                            ],
                            'target': 'S3_OBJECT'
                        }
                    },
                ]
            },
            'includes': {
                'and': [
                    {
                        'simpleScopeTerm': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'key': 'OBJECT_EXTENSION'|'OBJECT_LAST_MODIFIED_DATE'|'OBJECT_SIZE'|'OBJECT_KEY',
                            'values': [
                                'string',
                            ]
                        },
                        'tagScopeTerm': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'key': 'string',
                            'tagValues': [
                                {
                                    'key': 'string',
                                    'value': 'string'
                                },
                            ],
                            'target': 'S3_OBJECT'
                        }
                    },
                ]
            }
        },
        'bucketCriteria': {
            'excludes': {
                'and': [
                    {
                        'simpleCriterion': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'key': 'ACCOUNT_ID'|'S3_BUCKET_NAME'|'S3_BUCKET_EFFECTIVE_PERMISSION'|'S3_BUCKET_SHARED_ACCESS',
                            'values': [
                                'string',
                            ]
                        },
                        'tagCriterion': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'tagValues': [
                                {
                                    'key': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                ]
            },
            'includes': {
                'and': [
                    {
                        'simpleCriterion': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'key': 'ACCOUNT_ID'|'S3_BUCKET_NAME'|'S3_BUCKET_EFFECTIVE_PERMISSION'|'S3_BUCKET_SHARED_ACCESS',
                            'values': [
                                'string',
                            ]
                        },
                        'tagCriterion': {
                            'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                            'tagValues': [
                                {
                                    'key': 'string',
                                    'value': 'string'
                                },
                            ]
                        }
                    },
                ]
            }
        }
    },
    'samplingPercentage': 123,
    'scheduleFrequency': {
        'dailySchedule': {},
        'monthlySchedule': {
            'dayOfMonth': 123
        },
        'weeklySchedule': {
            'dayOfWeek': 'SUNDAY'|'MONDAY'|'TUESDAY'|'WEDNESDAY'|'THURSDAY'|'FRIDAY'|'SATURDAY'
        }
    },
    'statistics': {
        'approximateNumberOfObjectsToProcess': 123.0,
        'numberOfRuns': 123.0
    },
    'tags': {
        'string': 'string'
    },
    'userPausedDetails': {
        'jobExpiresAt': datetime(2015, 1, 1),
        'jobImminentExpirationHealthEventArn': 'string',
        'jobPausedAt': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    The request succeeded.

    • clientToken (string) --

      The token that was provided to ensure the idempotency of the request to create the job.

    • createdAt (datetime) --

      The date and time, in UTC and extended ISO 8601 format, when the job was created.

    • customDataIdentifierIds (list) --

      An array of unique identifiers, one for each custom data identifier that the job uses to analyze data. This value is null if the job uses only managed data identifiers to analyze data.

      • (string) --
    • description (string) --

      The custom description of the job.

    • initialRun (boolean) --

      For a recurring job, specifies whether you configured the job to analyze all existing, eligible objects immediately after the job was created (true). If you configured the job to analyze only those objects that were created or changed after the job was created and before the job's first scheduled run, this value is false. This value is also false for a one-time job.

    • jobArn (string) --

      The Amazon Resource Name (ARN) of the job.

    • jobId (string) --

      The unique identifier for the job.

    • jobStatus (string) --

      The current status of the job. Possible values are:

      • CANCELLED - You cancelled the job or, if it's a one-time job, you paused the job and didn't resume it within 30 days.
      • COMPLETE - For a one-time job, Amazon Macie finished processing the data specified for the job. This value doesn't apply to recurring jobs.
      • IDLE - For a recurring job, the previous scheduled run is complete and the next scheduled run is pending. This value doesn't apply to one-time jobs.
      • PAUSED - Macie started running the job but additional processing would exceed the monthly sensitive data discovery quota for your account or one or more member accounts that the job analyzes data for.
      • RUNNING - For a one-time job, the job is in progress. For a recurring job, a scheduled run is in progress.
      • USER_PAUSED - You paused the job. If you paused the job while it had a status of RUNNING and you don't resume it within 30 days of pausing it, the job or job run will expire and be cancelled, depending on the job's type. To check the expiration date, refer to the UserPausedDetails.jobExpiresAt property.
    • jobType (string) --

      The schedule for running the job. Possible values are:

      • ONE_TIME - The job runs only once.
      • SCHEDULED - The job runs on a daily, weekly, or monthly basis. The scheduleFrequency property indicates the recurrence pattern for the job.
    • lastRunErrorStatus (dict) --

      Specifies whether any account- or bucket-level access errors occurred when the job ran. For a recurring job, this value indicates the error status of the job's most recent run.

      • code (string) --

        Specifies whether any account- or bucket-level access errors occurred when the job ran. For a recurring job, this value indicates the error status of the job's most recent run. Possible values are:

        • ERROR - One or more errors occurred. Amazon Macie didn't process all the data specified for the job.
        • NONE - No errors occurred. Macie processed all the data specified for the job.
    • lastRunTime (datetime) --

      The date and time, in UTC and extended ISO 8601 format, when the job started. If the job is a recurring job, this value indicates when the most recent run started.

    • managedDataIdentifierIds (list) --

      An array of unique identifiers, one for each managed data identifier that the job is explicitly configured to include (use) or exclude (not use) when it analyzes data. Inclusion or exclusion depends on the managed data identifier selection type specified for the job (managedDataIdentifierSelector). This value is null if the job's managed data identifier selection type is ALL or the job uses only custom data identifiers (customDataIdentifierIds) to analyze data.

      • (string) --
    • managedDataIdentifierSelector (string) --

      The selection type that determines which managed data identifiers the job uses to analyze data. Possible values are:

      • ALL - Use all the managed data identifiers that Amazon Macie provides.
      • EXCLUDE - Use all the managed data identifiers that Macie provides except the managed data identifiers specified by the managedDataIdentifierIds property.
      • INCLUDE - Use only the managed data identifiers specified by the managedDataIdentifierIds property.
      • NONE - Don't use any managed data identifiers.

      If this value is null, the job uses all managed data identifiers. If this value is null, ALL, or EXCLUDE for a recurring job, the job also uses new managed data identifiers as they are released.

    • name (string) --

      The custom name of the job.

    • s3JobDefinition (dict) --

      The S3 buckets that contain the objects to analyze, and the scope of that analysis.

      • bucketDefinitions (list) --

        An array of objects, one for each Amazon Web Services account that owns specific S3 buckets to analyze. Each object specifies the account ID for an account and one or more buckets to analyze for that account. A job's definition can contain a bucketDefinitions array or a bucketCriteria object, not both.

        • (dict) --

          Specifies an Amazon Web Services account that owns S3 buckets for a classification job to analyze, and one or more specific buckets to analyze for that account.

          • accountId (string) --

            The unique identifier for the Amazon Web Services account that owns the buckets.

          • buckets (list) --

            An array that lists the names of the buckets.

            • (string) --
      • scoping (dict) --

        The property- and tag-based conditions that determine which S3 objects to include or exclude from the analysis. Each time the job runs, the job uses these criteria to determine which objects to analyze.

        • excludes (dict) --

          The property- and tag-based conditions that determine which objects to exclude from the analysis.

          • and (list) --

            An array of conditions, one for each property- or tag-based condition that determines which objects to include or exclude from the job. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

            • (dict) --

              Specifies a property- or tag-based condition that defines criteria for including or excluding S3 objects from a classification job. A JobScopeTerm object can contain only one simpleScopeTerm object or one tagScopeTerm object.

              • simpleScopeTerm (dict) --

                A property-based condition that defines a property, operator, and one or more values for including or excluding objects from the job.

                • comparator (string) --

                  The operator to use in the condition. Valid values for each supported property (key) are:

                  • OBJECT_EXTENSION - EQ (equals) or NE (not equals)
                  • OBJECT_KEY - STARTS_WITH
                  • OBJECT_LAST_MODIFIED_DATE - Any operator except CONTAINS
                  • OBJECT_SIZE - Any operator except CONTAINS
                • key (string) --

                  The object property to use in the condition.

                • values (list) --

                  An array that lists the values to use in the condition. If the value for the key property is OBJECT_EXTENSION or OBJECT_KEY, this array can specify multiple values and Amazon Macie uses OR logic to join the values. Otherwise, this array can specify only one value.

                  Valid values for each supported property (key) are:

                  • OBJECT_EXTENSION - A string that represents the file name extension of an object. For example: docx or pdf
                  • OBJECT_KEY - A string that represents the key prefix (folder name or path) of an object. For example: logs or awslogs/eventlogs. This value applies a condition to objects whose keys (names) begin with the specified value.
                  • OBJECT_LAST_MODIFIED_DATE - The date and time (in UTC and extended ISO 8601 format) when an object was created or last changed, whichever is latest. For example: 2020-09-28T14:31:13Z
                  • OBJECT_SIZE - An integer that represents the storage size (in bytes) of an object.

                  Macie doesn't support use of wildcard characters in these values. Also, string values are case sensitive.

                  • (string) --
              • tagScopeTerm (dict) --

                A tag-based condition that defines the operator and tag keys or tag key and value pairs for including or excluding objects from the job.

                • comparator (string) --

                  The operator to use in the condition. Valid values are EQ (equals) or NE (not equals).

                • key (string) --

                  The object property to use in the condition. The only valid value is TAG.

                • tagValues (list) --

                  The tag keys or tag key and value pairs to use in the condition. To specify only tag keys in a condition, specify the keys in this array and set the value for each associated tag value to an empty string.

                  • (dict) --

                    Specifies a tag key or tag key and value pair to use in a tag-based condition that determines whether an S3 object is included or excluded from a classification job. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based conditions.

                    • key (string) --

                      The value for the tag key to use in the condition.

                    • value (string) --

                      The tag value, associated with the specified tag key (key), to use in the condition. To specify only a tag key for a condition, specify the tag key for the key property and set this value to an empty string.

                • target (string) --

                  The type of object to apply the condition to.

        • includes (dict) --

          The property- and tag-based conditions that determine which objects to include in the analysis.

          • and (list) --

            An array of conditions, one for each property- or tag-based condition that determines which objects to include or exclude from the job. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

            • (dict) --

              Specifies a property- or tag-based condition that defines criteria for including or excluding S3 objects from a classification job. A JobScopeTerm object can contain only one simpleScopeTerm object or one tagScopeTerm object.

              • simpleScopeTerm (dict) --

                A property-based condition that defines a property, operator, and one or more values for including or excluding objects from the job.

                • comparator (string) --

                  The operator to use in the condition. Valid values for each supported property (key) are:

                  • OBJECT_EXTENSION - EQ (equals) or NE (not equals)
                  • OBJECT_KEY - STARTS_WITH
                  • OBJECT_LAST_MODIFIED_DATE - Any operator except CONTAINS
                  • OBJECT_SIZE - Any operator except CONTAINS
                • key (string) --

                  The object property to use in the condition.

                • values (list) --

                  An array that lists the values to use in the condition. If the value for the key property is OBJECT_EXTENSION or OBJECT_KEY, this array can specify multiple values and Amazon Macie uses OR logic to join the values. Otherwise, this array can specify only one value.

                  Valid values for each supported property (key) are:

                  • OBJECT_EXTENSION - A string that represents the file name extension of an object. For example: docx or pdf
                  • OBJECT_KEY - A string that represents the key prefix (folder name or path) of an object. For example: logs or awslogs/eventlogs. This value applies a condition to objects whose keys (names) begin with the specified value.
                  • OBJECT_LAST_MODIFIED_DATE - The date and time (in UTC and extended ISO 8601 format) when an object was created or last changed, whichever is latest. For example: 2020-09-28T14:31:13Z
                  • OBJECT_SIZE - An integer that represents the storage size (in bytes) of an object.

                  Macie doesn't support use of wildcard characters in these values. Also, string values are case sensitive.

                  • (string) --
              • tagScopeTerm (dict) --

                A tag-based condition that defines the operator and tag keys or tag key and value pairs for including or excluding objects from the job.

                • comparator (string) --

                  The operator to use in the condition. Valid values are EQ (equals) or NE (not equals).

                • key (string) --

                  The object property to use in the condition. The only valid value is TAG.

                • tagValues (list) --

                  The tag keys or tag key and value pairs to use in the condition. To specify only tag keys in a condition, specify the keys in this array and set the value for each associated tag value to an empty string.

                  • (dict) --

                    Specifies a tag key or tag key and value pair to use in a tag-based condition that determines whether an S3 object is included or excluded from a classification job. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based conditions.

                    • key (string) --

                      The value for the tag key to use in the condition.

                    • value (string) --

                      The tag value, associated with the specified tag key (key), to use in the condition. To specify only a tag key for a condition, specify the tag key for the key property and set this value to an empty string.

                • target (string) --

                  The type of object to apply the condition to.

      • bucketCriteria (dict) --

        The property- and tag-based conditions that determine which S3 buckets to include or exclude from the analysis. Each time the job runs, the job uses these criteria to determine which buckets contain objects to analyze. A job's definition can contain a bucketCriteria object or a bucketDefinitions array, not both.

        • excludes (dict) --

          The property- and tag-based conditions that determine which buckets to exclude from the job.

          • and (list) --

            An array of conditions, one for each condition that determines which buckets to include or exclude from the job. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

            • (dict) --

              Specifies a property- or tag-based condition that defines criteria for including or excluding S3 buckets from a classification job.

              • simpleCriterion (dict) --

                A property-based condition that defines a property, operator, and one or more values for including or excluding buckets from the job.

                • comparator (string) --

                  The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

                • key (string) --

                  The property to use in the condition.

                • values (list) --

                  An array that lists one or more values to use in the condition. If you specify multiple values, Amazon Macie uses OR logic to join the values. Valid values for each supported property (key) are:

                  • ACCOUNT_ID - A string that represents the unique identifier for the Amazon Web Services account that owns the bucket.
                  • S3_BUCKET_EFFECTIVE_PERMISSION - A string that represents an enumerated value that Macie defines for the BucketPublicAccess.effectivePermission property of a bucket.
                  • S3_BUCKET_NAME - A string that represents the name of a bucket.
                  • S3_BUCKET_SHARED_ACCESS - A string that represents an enumerated value that Macie defines for the BucketMetadata.sharedAccess property of a bucket.

                  Values are case sensitive. Also, Macie doesn't support use of partial values or wildcard characters in these values.

                  • (string) --
              • tagCriterion (dict) --

                A tag-based condition that defines an operator and tag keys, tag values, or tag key and value pairs for including or excluding buckets from the job.

                • comparator (string) --

                  The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

                • tagValues (list) --

                  The tag keys, tag values, or tag key and value pairs to use in the condition.

                  • (dict) --

                    Specifies a tag key, a tag value, or a tag key and value (as a pair) to use in a tag-based condition that determines whether an S3 bucket is included or excluded from a classification job. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based conditions.

                    • key (string) --

                      The value for the tag key to use in the condition.

                    • value (string) --

                      The tag value to use in the condition.

        • includes (dict) --

          The property- and tag-based conditions that determine which buckets to include in the job.

          • and (list) --

            An array of conditions, one for each condition that determines which buckets to include or exclude from the job. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

            • (dict) --

              Specifies a property- or tag-based condition that defines criteria for including or excluding S3 buckets from a classification job.

              • simpleCriterion (dict) --

                A property-based condition that defines a property, operator, and one or more values for including or excluding buckets from the job.

                • comparator (string) --

                  The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

                • key (string) --

                  The property to use in the condition.

                • values (list) --

                  An array that lists one or more values to use in the condition. If you specify multiple values, Amazon Macie uses OR logic to join the values. Valid values for each supported property (key) are:

                  • ACCOUNT_ID - A string that represents the unique identifier for the Amazon Web Services account that owns the bucket.
                  • S3_BUCKET_EFFECTIVE_PERMISSION - A string that represents an enumerated value that Macie defines for the BucketPublicAccess.effectivePermission property of a bucket.
                  • S3_BUCKET_NAME - A string that represents the name of a bucket.
                  • S3_BUCKET_SHARED_ACCESS - A string that represents an enumerated value that Macie defines for the BucketMetadata.sharedAccess property of a bucket.

                  Values are case sensitive. Also, Macie doesn't support use of partial values or wildcard characters in these values.

                  • (string) --
              • tagCriterion (dict) --

                A tag-based condition that defines an operator and tag keys, tag values, or tag key and value pairs for including or excluding buckets from the job.

                • comparator (string) --

                  The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

                • tagValues (list) --

                  The tag keys, tag values, or tag key and value pairs to use in the condition.

                  • (dict) --

                    Specifies a tag key, a tag value, or a tag key and value (as a pair) to use in a tag-based condition that determines whether an S3 bucket is included or excluded from a classification job. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based conditions.

                    • key (string) --

                      The value for the tag key to use in the condition.

                    • value (string) --

                      The tag value to use in the condition.

    • samplingPercentage (integer) --

      The sampling depth, as a percentage, that determines the percentage of eligible objects that the job analyzes.

    • scheduleFrequency (dict) --

      The recurrence pattern for running the job. This value is null if the job is configured to run only once.

      • dailySchedule (dict) --

        Specifies a daily recurrence pattern for running the job.

      • monthlySchedule (dict) --

        Specifies a monthly recurrence pattern for running the job.

        • dayOfMonth (integer) --

          The numeric day of the month when Amazon Macie runs the job. This value can be an integer from 1 through 31.

          If this value exceeds the number of days in a certain month, Macie doesn't run the job that month. Macie runs the job only during months that have the specified day. For example, if this value is 31 and a month has only 30 days, Macie doesn't run the job that month. To run the job every month, specify a value that's less than 29.

      • weeklySchedule (dict) --

        Specifies a weekly recurrence pattern for running the job.

        • dayOfWeek (string) --

          The day of the week when Amazon Macie runs the job.

    • statistics (dict) --

      The number of times that the job has run and processing statistics for the job's current run.

      • approximateNumberOfObjectsToProcess (float) --

        The approximate number of objects that the job has yet to process during its current run.

      • numberOfRuns (float) --

        The number of times that the job has run.

    • tags (dict) --

      A map of key-value pairs that specifies which tags (keys and values) are associated with the classification job.

      • (string) --
        • (string) --
    • userPausedDetails (dict) --

      If the current status of the job is USER_PAUSED, specifies when the job was paused and when the job or job run will expire and be cancelled if it isn't resumed. This value is present only if the value for jobStatus is USER_PAUSED.

      • jobExpiresAt (datetime) --

        The date and time, in UTC and extended ISO 8601 format, when the job or job run will expire and be cancelled if you don't resume it first.

      • jobImminentExpirationHealthEventArn (string) --

        The Amazon Resource Name (ARN) of the Health event that Amazon Macie sent to notify you of the job or job run's pending expiration and cancellation. This value is null if a job has been paused for less than 23 days.

      • jobPausedAt (datetime) --

        The date and time, in UTC and extended ISO 8601 format, when you paused the job.

Exceptions

describe_organization_configuration()

Retrieves the Amazon Macie configuration settings for an Amazon Web Services organization.

See also: AWS API Documentation

Request Syntax

response = client.describe_organization_configuration()
Return type
dict
Returns
Response Syntax
{
    'autoEnable': True|False,
    'maxAccountLimitReached': True|False
}

Response Structure

  • (dict) --

    The request succeeded.

    • autoEnable (boolean) --

      Specifies whether Amazon Macie is enabled automatically for accounts that are added to the Amazon Web Services organization.

    • maxAccountLimitReached (boolean) --

      Specifies whether the maximum number of Amazon Macie member accounts are part of the Amazon Web Services organization.

Exceptions

disable_macie()

Disables an Amazon Macie account and deletes Macie resources for the account.

See also: AWS API Documentation

Request Syntax

response = client.disable_macie()
Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --

    The request succeeded and there isn't any content to include in the body of the response (No Content).

Exceptions

disable_organization_admin_account(**kwargs)

Disables an account as the delegated Amazon Macie administrator account for an Amazon Web Services organization.

See also: AWS API Documentation

Request Syntax

response = client.disable_organization_admin_account(
    adminAccountId='string'
)
Parameters
adminAccountId (string) --

[REQUIRED]

The Amazon Web Services account ID of the delegated Amazon Macie administrator account.

Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --

    The request succeeded and there isn't any content to include in the body of the response (No Content).

Exceptions

disassociate_from_administrator_account()

Disassociates a member account from its Amazon Macie administrator account.

See also: AWS API Documentation

Request Syntax

response = client.disassociate_from_administrator_account()
Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --

Exceptions

disassociate_from_master_account()

(Deprecated) Disassociates a member account from its Amazon Macie administrator account. This operation has been replaced by the DisassociateFromAdministratorAccountoperation.

See also: AWS API Documentation

Request Syntax

response = client.disassociate_from_master_account()
Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --

    The request succeeded and there isn't any content to include in the body of the response (No Content).

Exceptions

disassociate_member(**kwargs)

Disassociates an Amazon Macie administrator account from a member account.

See also: AWS API Documentation

Request Syntax

response = client.disassociate_member(
    id='string'
)
Parameters
id (string) --

[REQUIRED]

The unique identifier for the Amazon Macie resource or account that the request applies to.

Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --

    The request succeeded.

Exceptions

enable_macie(**kwargs)

Enables Amazon Macie and specifies the configuration settings for a Macie account.

See also: AWS API Documentation

Request Syntax

response = client.enable_macie(
    clientToken='string',
    findingPublishingFrequency='FIFTEEN_MINUTES'|'ONE_HOUR'|'SIX_HOURS',
    status='PAUSED'|'ENABLED'
)
Parameters
  • clientToken (string) --

    A unique, case-sensitive token that you provide to ensure the idempotency of the request.

    This field is autopopulated if not provided.

  • findingPublishingFrequency (string) -- Specifies how often to publish updates to policy findings for the account. This includes publishing updates to Security Hub and Amazon EventBridge (formerly called Amazon CloudWatch Events).
  • status (string) -- Specifies the new status for the account. To enable Amazon Macie and start all Macie activities for the account, set this value to ENABLED.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

    The request succeeded and there isn't any content to include in the body of the response (No Content).

Exceptions

enable_organization_admin_account(**kwargs)

Designates an account as the delegated Amazon Macie administrator account for an Amazon Web Services organization.

See also: AWS API Documentation

Request Syntax

response = client.enable_organization_admin_account(
    adminAccountId='string',
    clientToken='string'
)
Parameters
  • adminAccountId (string) --

    [REQUIRED]

    The Amazon Web Services account ID for the account to designate as the delegated Amazon Macie administrator account for the organization.

  • clientToken (string) --

    A unique, case-sensitive token that you provide to ensure the idempotency of the request.

    This field is autopopulated if not provided.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

    The request succeeded and there isn't any content to include in the body of the response (No Content).

Exceptions

generate_presigned_url(ClientMethod, Params=None, ExpiresIn=3600, HttpMethod=None)

Generate a presigned url given a client, its method, and arguments

Parameters
  • ClientMethod (string) -- The client method to presign for
  • Params (dict) -- The parameters normally passed to ClientMethod.
  • ExpiresIn (int) -- The number of seconds the presigned url is valid for. By default it expires in an hour (3600 seconds)
  • HttpMethod (string) -- The http method to use on the generated url. By default, the http method is whatever is used in the method's model.
Returns

The presigned url

get_administrator_account()

Retrieves information about the Amazon Macie administrator account for an account.

See also: AWS API Documentation

Request Syntax

response = client.get_administrator_account()
Return type
dict
Returns
Response Syntax
{
    'administrator': {
        'accountId': 'string',
        'invitationId': 'string',
        'invitedAt': datetime(2015, 1, 1),
        'relationshipStatus': 'Enabled'|'Paused'|'Invited'|'Created'|'Removed'|'Resigned'|'EmailVerificationInProgress'|'EmailVerificationFailed'|'RegionDisabled'|'AccountSuspended'
    }
}

Response Structure

  • (dict) --
    • administrator (dict) --

      The Amazon Web Services account ID for the administrator account. If the accounts are associated by a Macie membership invitation, this object also provides details about the invitation that was sent to establish the relationship between the accounts.

      • accountId (string) --

        The Amazon Web Services account ID for the account that sent the invitation.

      • invitationId (string) --

        The unique identifier for the invitation. Amazon Macie uses this identifier to validate the inviter account with the invitee account.

      • invitedAt (datetime) --

        The date and time, in UTC and extended ISO 8601 format, when the invitation was sent.

      • relationshipStatus (string) --

        The status of the relationship between the account that sent the invitation (inviter account ) and the account that received the invitation (invitee account ).

Exceptions

get_bucket_statistics(**kwargs)

Retrieves (queries) aggregated statistical data for all the S3 buckets that Amazon Macie monitors and analyzes.

See also: AWS API Documentation

Request Syntax

response = client.get_bucket_statistics(
    accountId='string'
)
Parameters
accountId (string) -- The unique identifier for the Amazon Web Services account.
Return type
dict
Returns
Response Syntax
{
    'bucketCount': 123,
    'bucketCountByEffectivePermission': {
        'publiclyAccessible': 123,
        'publiclyReadable': 123,
        'publiclyWritable': 123,
        'unknown': 123
    },
    'bucketCountByEncryptionType': {
        'kmsManaged': 123,
        's3Managed': 123,
        'unencrypted': 123,
        'unknown': 123
    },
    'bucketCountByObjectEncryptionRequirement': {
        'allowsUnencryptedObjectUploads': 123,
        'deniesUnencryptedObjectUploads': 123,
        'unknown': 123
    },
    'bucketCountBySharedAccessType': {
        'external': 123,
        'internal': 123,
        'notShared': 123,
        'unknown': 123
    },
    'classifiableObjectCount': 123,
    'classifiableSizeInBytes': 123,
    'lastUpdated': datetime(2015, 1, 1),
    'objectCount': 123,
    'sizeInBytes': 123,
    'sizeInBytesCompressed': 123,
    'unclassifiableObjectCount': {
        'fileType': 123,
        'storageClass': 123,
        'total': 123
    },
    'unclassifiableObjectSizeInBytes': {
        'fileType': 123,
        'storageClass': 123,
        'total': 123
    }
}

Response Structure

  • (dict) --

    The request succeeded.

    • bucketCount (integer) --

      The total number of buckets.

    • bucketCountByEffectivePermission (dict) --

      The total number of buckets that are publicly accessible based on a combination of permissions settings for each bucket.

      • publiclyAccessible (integer) --

        The total number of buckets that allow the general public to have read or write access to the bucket.

      • publiclyReadable (integer) --

        The total number of buckets that allow the general public to have read access to the bucket.

      • publiclyWritable (integer) --

        The total number of buckets that allow the general public to have write access to the bucket.

      • unknown (integer) --

        The total number of buckets that Amazon Macie wasn't able to evaluate permissions settings for. Macie can't determine whether these buckets are publicly accessible.

    • bucketCountByEncryptionType (dict) --

      The total number of buckets that use certain types of server-side encryption to encrypt new objects by default. This object also reports the total number of buckets that don't encrypt new objects by default.

      • kmsManaged (integer) --

        The total number of buckets that use an KMS key to encrypt new objects by default, either an Amazon Web Services managed key or a customer managed key. These buckets use KMS encryption (SSE-KMS) by default.

      • s3Managed (integer) --

        The total number of buckets that use an Amazon S3 managed key to encrypt new objects by default. These buckets use Amazon S3 managed encryption (SSE-S3) by default.

      • unencrypted (integer) --

        The total number of buckets that don't encrypt new objects by default. Default encryption is disabled for these buckets.

      • unknown (integer) --

        The total number of buckets that Amazon Macie doesn't have current encryption metadata for. Macie can't provide current data about the default encryption settings for these buckets.

    • bucketCountByObjectEncryptionRequirement (dict) --

      The total number of buckets whose bucket policies do or don't require server-side encryption of objects when objects are uploaded to the buckets.

      • allowsUnencryptedObjectUploads (integer) --

        The total number of buckets that don't have a bucket policy or have a bucket policy that doesn't require server-side encryption of new objects. If a bucket policy exists, the policy doesn't require PutObject requests to include the x-amz-server-side-encryption header and it doesn't require the value for that header to be AES256 or aws:kms.

      • deniesUnencryptedObjectUploads (integer) --

        The total number of buckets whose bucket policies require server-side encryption of new objects. PutObject requests for these buckets must include the x-amz-server-side-encryption header and the value for that header must be AES256 or aws:kms.

      • unknown (integer) --

        The total number of buckets that Amazon Macie wasn't able to evaluate server-side encryption requirements for. Macie can't determine whether the bucket policies for these buckets require server-side encryption of new objects.

    • bucketCountBySharedAccessType (dict) --

      The total number of buckets that are or aren't shared with another Amazon Web Services account.

      • external (integer) --

        The total number of buckets that are shared with an Amazon Web Services account that isn't part of the same Amazon Macie organization.

      • internal (integer) --

        The total number of buckets that are shared with an Amazon Web Services account that's part of the same Amazon Macie organization.

      • notShared (integer) --

        The total number of buckets that aren't shared with other Amazon Web Services accounts.

      • unknown (integer) --

        The total number of buckets that Amazon Macie wasn't able to evaluate shared access settings for. Macie can't determine whether these buckets are shared with other Amazon Web Services accounts.

    • classifiableObjectCount (integer) --

      The total number of objects that Amazon Macie can analyze in the buckets. These objects use a supported storage class and have a file name extension for a supported file or storage format.

    • classifiableSizeInBytes (integer) --

      The total storage size, in bytes, of all the objects that Amazon Macie can analyze in the buckets. These objects use a supported storage class and have a file name extension for a supported file or storage format.

      If versioning is enabled for any of the buckets, Macie calculates this value based on the size of the latest version of each applicable object in those buckets. This value doesn't reflect the storage size of all versions of all applicable objects in the buckets.

    • lastUpdated (datetime) --

      The date and time, in UTC and extended ISO 8601 format, when Amazon Macie most recently retrieved both bucket and object metadata from Amazon S3 for the buckets.

    • objectCount (integer) --

      The total number of objects in the buckets.

    • sizeInBytes (integer) --

      The total storage size, in bytes, of the buckets.

      If versioning is enabled for any of the buckets, Amazon Macie calculates this value based on the size of the latest version of each object in those buckets. This value doesn't reflect the storage size of all versions of the objects in the buckets.

    • sizeInBytesCompressed (integer) --

      The total storage size, in bytes, of the objects that are compressed (.gz, .gzip, .zip) files in the buckets.

      If versioning is enabled for any of the buckets, Amazon Macie calculates this value based on the size of the latest version of each applicable object in those buckets. This value doesn't reflect the storage size of all versions of the applicable objects in the buckets.

    • unclassifiableObjectCount (dict) --

      The total number of objects that Amazon Macie can't analyze in the buckets. These objects don't use a supported storage class or don't have a file name extension for a supported file or storage format.

      • fileType (integer) --

        The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects don't have a file name extension for a supported file or storage format.

      • storageClass (integer) --

        The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class.

      • total (integer) --

        The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class or don't have a file name extension for a supported file or storage format.

    • unclassifiableObjectSizeInBytes (dict) --

      The total storage size, in bytes, of the objects that Amazon Macie can't analyze in the buckets. These objects don't use a supported storage class or don't have a file name extension for a supported file or storage format.

      • fileType (integer) --

        The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects don't have a file name extension for a supported file or storage format.

      • storageClass (integer) --

        The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class.

      • total (integer) --

        The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class or don't have a file name extension for a supported file or storage format.

Exceptions

get_classification_export_configuration()

Retrieves the configuration settings for storing data classification results.

See also: AWS API Documentation

Request Syntax

response = client.get_classification_export_configuration()
Return type
dict
Returns
Response Syntax
{
    'configuration': {
        's3Destination': {
            'bucketName': 'string',
            'keyPrefix': 'string',
            'kmsKeyArn': 'string'
        }
    }
}

Response Structure

  • (dict) --

    The request succeeded.

    • configuration (dict) --

      The location where data classification results are stored, and the encryption settings that are used when storing results in that location.

      • s3Destination (dict) --

        The S3 bucket to store data classification results in, and the encryption settings to use when storing results in that bucket.

        • bucketName (string) --

          The name of the bucket.

        • keyPrefix (string) --

          The path prefix to use in the path to the location in the bucket. This prefix specifies where to store classification results in the bucket.

        • kmsKeyArn (string) --

          The Amazon Resource Name (ARN) of the KMS key to use for encryption of the results. This must be the ARN of an existing, symmetric, customer managed KMS key that's in the same Amazon Web Services Region as the bucket.

Exceptions

get_custom_data_identifier(**kwargs)

Retrieves the criteria and other settings for a custom data identifier.

See also: AWS API Documentation

Request Syntax

response = client.get_custom_data_identifier(
    id='string'
)
Parameters
id (string) --

[REQUIRED]

The unique identifier for the Amazon Macie resource or account that the request applies to.

Return type
dict
Returns
Response Syntax
{
    'arn': 'string',
    'createdAt': datetime(2015, 1, 1),
    'deleted': True|False,
    'description': 'string',
    'id': 'string',
    'ignoreWords': [
        'string',
    ],
    'keywords': [
        'string',
    ],
    'maximumMatchDistance': 123,
    'name': 'string',
    'regex': 'string',
    'tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    The request succeeded.

    • arn (string) --

      The Amazon Resource Name (ARN) of the custom data identifier.

    • createdAt (datetime) --

      The date and time, in UTC and extended ISO 8601 format, when the custom data identifier was created.

    • deleted (boolean) --

      Specifies whether the custom data identifier was deleted. If you delete a custom data identifier, Amazon Macie doesn't delete it permanently. Instead, it soft deletes the identifier.

    • description (string) --

      The custom description of the custom data identifier.

    • id (string) --

      The unique identifier for the custom data identifier.

    • ignoreWords (list) --

      An array that lists specific character sequences (ignore words) to exclude from the results. If the text matched by the regular expression is the same as any string in this array, Amazon Macie ignores it. Ignore words are case sensitive.

      • (string) --
    • keywords (list) --

      An array that lists specific character sequences (keywords), one of which must be within proximity (maximumMatchDistance) of the regular expression to match. Keywords aren't case sensitive.

      • (string) --
    • maximumMatchDistance (integer) --

      The maximum number of characters that can exist between text that matches the regex pattern and the character sequences specified by the keywords array. Amazon Macie includes or excludes a result based on the proximity of a keyword to text that matches the regex pattern.

    • name (string) --

      The custom name of the custom data identifier.

    • regex (string) --

      The regular expression (regex ) that defines the pattern to match.

    • tags (dict) --

      A map of key-value pairs that identifies the tags (keys and values) that are associated with the custom data identifier.

      • (string) --
        • (string) --

Exceptions

get_finding_statistics(**kwargs)

Retrieves (queries) aggregated statistical data about findings.

See also: AWS API Documentation

Request Syntax

response = client.get_finding_statistics(
    findingCriteria={
        'criterion': {
            'string': {
                'eq': [
                    'string',
                ],
                'eqExactMatch': [
                    'string',
                ],
                'gt': 123,
                'gte': 123,
                'lt': 123,
                'lte': 123,
                'neq': [
                    'string',
                ]
            }
        }
    },
    groupBy='resourcesAffected.s3Bucket.name'|'type'|'classificationDetails.jobId'|'severity.description',
    size=123,
    sortCriteria={
        'attributeName': 'groupKey'|'count',
        'orderBy': 'ASC'|'DESC'
    }
)
Parameters
  • findingCriteria (dict) --

    The criteria to use to filter the query results.

    • criterion (dict) --

      A condition that specifies the property, operator, and one or more values to use to filter the results.

      • (string) --
        • (dict) --

          Specifies the operator to use in a property-based condition that filters the results of a query for findings. For detailed information and examples of each operator, see Fundamentals of filtering findings in the Amazon Macie User Guide .

          • eq (list) --

            The value for the property matches (equals) the specified value. If you specify multiple values, Macie uses OR logic to join the values.

            • (string) --
          • eqExactMatch (list) --

            The value for the property exclusively matches (equals an exact match for) all the specified values. If you specify multiple values, Amazon Macie uses AND logic to join the values.

            You can use this operator with the following properties: customDataIdentifiers.detections.arn, customDataIdentifiers.detections.name, resourcesAffected.s3Bucket.tags.key, resourcesAffected.s3Bucket.tags.value, resourcesAffected.s3Object.tags.key, resourcesAffected.s3Object.tags.value, sensitiveData.category, and sensitiveData.detections.type.

            • (string) --
          • gt (integer) --

            The value for the property is greater than the specified value.

          • gte (integer) --

            The value for the property is greater than or equal to the specified value.

          • lt (integer) --

            The value for the property is less than the specified value.

          • lte (integer) --

            The value for the property is less than or equal to the specified value.

          • neq (list) --

            The value for the property doesn't match (doesn't equal) the specified value. If you specify multiple values, Macie uses OR logic to join the values.

            • (string) --
  • groupBy (string) --

    [REQUIRED]

    The finding property to use to group the query results. Valid values are:

    • classificationDetails.jobId - The unique identifier for the classification job that produced the finding.
    • resourcesAffected.s3Bucket.name - The name of the S3 bucket that the finding applies to.
    • severity.description - The severity level of the finding, such as High or Medium.
    • type - The type of finding, such as Policy:IAMUser/S3BucketPublic and SensitiveData:S3Object/Personal.
  • size (integer) -- The maximum number of items to include in each page of the response.
  • sortCriteria (dict) --

    The criteria to use to sort the query results.

    • attributeName (string) --

      The grouping to sort the results by. Valid values are: count, sort the results by the number of findings in each group of results; and, groupKey, sort the results by the name of each group of results.

    • orderBy (string) --

      The sort order to apply to the results, based on the value for the property specified by the attributeName property. Valid values are: ASC, sort the results in ascending order; and, DESC, sort the results in descending order.

Return type

dict

Returns

Response Syntax

{
    'countsByGroup': [
        {
            'count': 123,
            'groupKey': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    The request succeeded.

    • countsByGroup (list) --

      An array of objects, one for each group of findings that meet the filter criteria specified in the request.

      • (dict) --

        Provides a group of results for a query that retrieved aggregated statistical data about findings.

        • count (integer) --

          The total number of findings in the group of query results.

        • groupKey (string) --

          The name of the property that defines the group in the query results, as specified by the groupBy property in the query request.

Exceptions

get_findings(**kwargs)

Retrieves the details of one or more findings.

See also: AWS API Documentation

Request Syntax

response = client.get_findings(
    findingIds=[
        'string',
    ],
    sortCriteria={
        'attributeName': 'string',
        'orderBy': 'ASC'|'DESC'
    }
)
Parameters
  • findingIds (list) --

    [REQUIRED]

    An array of strings that lists the unique identifiers for the findings to retrieve.

    • (string) --
  • sortCriteria (dict) --

    The criteria for sorting the results of the request.

    • attributeName (string) --

      The name of the property to sort the results by. This value can be the name of any property that Amazon Macie defines for a finding.

    • orderBy (string) --

      The sort order to apply to the results, based on the value for the property specified by the attributeName property. Valid values are: ASC, sort the results in ascending order; and, DESC, sort the results in descending order.

Return type

dict

Returns

Response Syntax

{
    'findings': [
        {
            'accountId': 'string',
            'archived': True|False,
            'category': 'CLASSIFICATION'|'POLICY',
            'classificationDetails': {
                'detailedResultsLocation': 'string',
                'jobArn': 'string',
                'jobId': 'string',
                'result': {
                    'additionalOccurrences': True|False,
                    'customDataIdentifiers': {
                        'detections': [
                            {
                                'arn': 'string',
                                'count': 123,
                                'name': 'string',
                                'occurrences': {
                                    'cells': [
                                        {
                                            'cellReference': 'string',
                                            'column': 123,
                                            'columnName': 'string',
                                            'row': 123
                                        },
                                    ],
                                    'lineRanges': [
                                        {
                                            'end': 123,
                                            'start': 123,
                                            'startColumn': 123
                                        },
                                    ],
                                    'offsetRanges': [
                                        {
                                            'end': 123,
                                            'start': 123,
                                            'startColumn': 123
                                        },
                                    ],
                                    'pages': [
                                        {
                                            'lineRange': {
                                                'end': 123,
                                                'start': 123,
                                                'startColumn': 123
                                            },
                                            'offsetRange': {
                                                'end': 123,
                                                'start': 123,
                                                'startColumn': 123
                                            },
                                            'pageNumber': 123
                                        },
                                    ],
                                    'records': [
                                        {
                                            'jsonPath': 'string',
                                            'recordIndex': 123
                                        },
                                    ]
                                }
                            },
                        ],
                        'totalCount': 123
                    },
                    'mimeType': 'string',
                    'sensitiveData': [
                        {
                            'category': 'FINANCIAL_INFORMATION'|'PERSONAL_INFORMATION'|'CREDENTIALS'|'CUSTOM_IDENTIFIER',
                            'detections': [
                                {
                                    'count': 123,
                                    'occurrences': {
                                        'cells': [
                                            {
                                                'cellReference': 'string',
                                                'column': 123,
                                                'columnName': 'string',
                                                'row': 123
                                            },
                                        ],
                                        'lineRanges': [
                                            {
                                                'end': 123,
                                                'start': 123,
                                                'startColumn': 123
                                            },
                                        ],
                                        'offsetRanges': [
                                            {
                                                'end': 123,
                                                'start': 123,
                                                'startColumn': 123
                                            },
                                        ],
                                        'pages': [
                                            {
                                                'lineRange': {
                                                    'end': 123,
                                                    'start': 123,
                                                    'startColumn': 123
                                                },
                                                'offsetRange': {
                                                    'end': 123,
                                                    'start': 123,
                                                    'startColumn': 123
                                                },
                                                'pageNumber': 123
                                            },
                                        ],
                                        'records': [
                                            {
                                                'jsonPath': 'string',
                                                'recordIndex': 123
                                            },
                                        ]
                                    },
                                    'type': 'string'
                                },
                            ],
                            'totalCount': 123
                        },
                    ],
                    'sizeClassified': 123,
                    'status': {
                        'code': 'string',
                        'reason': 'string'
                    }
                }
            },
            'count': 123,
            'createdAt': datetime(2015, 1, 1),
            'description': 'string',
            'id': 'string',
            'partition': 'string',
            'policyDetails': {
                'action': {
                    'actionType': 'AWS_API_CALL',
                    'apiCallDetails': {
                        'api': 'string',
                        'apiServiceName': 'string',
                        'firstSeen': datetime(2015, 1, 1),
                        'lastSeen': datetime(2015, 1, 1)
                    }
                },
                'actor': {
                    'domainDetails': {
                        'domainName': 'string'
                    },
                    'ipAddressDetails': {
                        'ipAddressV4': 'string',
                        'ipCity': {
                            'name': 'string'
                        },
                        'ipCountry': {
                            'code': 'string',
                            'name': 'string'
                        },
                        'ipGeoLocation': {
                            'lat': 123.0,
                            'lon': 123.0
                        },
                        'ipOwner': {
                            'asn': 'string',
                            'asnOrg': 'string',
                            'isp': 'string',
                            'org': 'string'
                        }
                    },
                    'userIdentity': {
                        'assumedRole': {
                            'accessKeyId': 'string',
                            'accountId': 'string',
                            'arn': 'string',
                            'principalId': 'string',
                            'sessionContext': {
                                'attributes': {
                                    'creationDate': datetime(2015, 1, 1),
                                    'mfaAuthenticated': True|False
                                },
                                'sessionIssuer': {
                                    'accountId': 'string',
                                    'arn': 'string',
                                    'principalId': 'string',
                                    'type': 'string',
                                    'userName': 'string'
                                }
                            }
                        },
                        'awsAccount': {
                            'accountId': 'string',
                            'principalId': 'string'
                        },
                        'awsService': {
                            'invokedBy': 'string'
                        },
                        'federatedUser': {
                            'accessKeyId': 'string',
                            'accountId': 'string',
                            'arn': 'string',
                            'principalId': 'string',
                            'sessionContext': {
                                'attributes': {
                                    'creationDate': datetime(2015, 1, 1),
                                    'mfaAuthenticated': True|False
                                },
                                'sessionIssuer': {
                                    'accountId': 'string',
                                    'arn': 'string',
                                    'principalId': 'string',
                                    'type': 'string',
                                    'userName': 'string'
                                }
                            }
                        },
                        'iamUser': {
                            'accountId': 'string',
                            'arn': 'string',
                            'principalId': 'string',
                            'userName': 'string'
                        },
                        'root': {
                            'accountId': 'string',
                            'arn': 'string',
                            'principalId': 'string'
                        },
                        'type': 'AssumedRole'|'IAMUser'|'FederatedUser'|'Root'|'AWSAccount'|'AWSService'
                    }
                }
            },
            'region': 'string',
            'resourcesAffected': {
                's3Bucket': {
                    'allowsUnencryptedObjectUploads': 'TRUE'|'FALSE'|'UNKNOWN',
                    'arn': 'string',
                    'createdAt': datetime(2015, 1, 1),
                    'defaultServerSideEncryption': {
                        'encryptionType': 'NONE'|'AES256'|'aws:kms'|'UNKNOWN',
                        'kmsMasterKeyId': 'string'
                    },
                    'name': 'string',
                    'owner': {
                        'displayName': 'string',
                        'id': 'string'
                    },
                    'publicAccess': {
                        'effectivePermission': 'PUBLIC'|'NOT_PUBLIC'|'UNKNOWN',
                        'permissionConfiguration': {
                            'accountLevelPermissions': {
                                'blockPublicAccess': {
                                    'blockPublicAcls': True|False,
                                    'blockPublicPolicy': True|False,
                                    'ignorePublicAcls': True|False,
                                    'restrictPublicBuckets': True|False
                                }
                            },
                            'bucketLevelPermissions': {
                                'accessControlList': {
                                    'allowsPublicReadAccess': True|False,
                                    'allowsPublicWriteAccess': True|False
                                },
                                'blockPublicAccess': {
                                    'blockPublicAcls': True|False,
                                    'blockPublicPolicy': True|False,
                                    'ignorePublicAcls': True|False,
                                    'restrictPublicBuckets': True|False
                                },
                                'bucketPolicy': {
                                    'allowsPublicReadAccess': True|False,
                                    'allowsPublicWriteAccess': True|False
                                }
                            }
                        }
                    },
                    'tags': [
                        {
                            'key': 'string',
                            'value': 'string'
                        },
                    ]
                },
                's3Object': {
                    'bucketArn': 'string',
                    'eTag': 'string',
                    'extension': 'string',
                    'key': 'string',
                    'lastModified': datetime(2015, 1, 1),
                    'path': 'string',
                    'publicAccess': True|False,
                    'serverSideEncryption': {
                        'encryptionType': 'NONE'|'AES256'|'aws:kms'|'UNKNOWN',
                        'kmsMasterKeyId': 'string'
                    },
                    'size': 123,
                    'storageClass': 'STANDARD'|'REDUCED_REDUNDANCY'|'STANDARD_IA'|'INTELLIGENT_TIERING'|'DEEP_ARCHIVE'|'ONEZONE_IA'|'GLACIER',
                    'tags': [
                        {
                            'key': 'string',
                            'value': 'string'
                        },
                    ],
                    'versionId': 'string'
                }
            },
            'sample': True|False,
            'schemaVersion': 'string',
            'severity': {
                'description': 'Low'|'Medium'|'High',
                'score': 123
            },
            'title': 'string',
            'type': 'SensitiveData:S3Object/Multiple'|'SensitiveData:S3Object/Financial'|'SensitiveData:S3Object/Personal'|'SensitiveData:S3Object/Credentials'|'SensitiveData:S3Object/CustomIdentifier'|'Policy:IAMUser/S3BucketPublic'|'Policy:IAMUser/S3BucketSharedExternally'|'Policy:IAMUser/S3BucketReplicatedExternally'|'Policy:IAMUser/S3BucketEncryptionDisabled'|'Policy:IAMUser/S3BlockPublicAccessDisabled',
            'updatedAt': datetime(2015, 1, 1)
        },
    ]
}

Response Structure

  • (dict) --

    The request succeeded.

    • findings (list) --

      An array of objects, one for each finding that meets the criteria specified in the request.

      • (dict) --

        Provides the details of a finding.

        • accountId (string) --

          The unique identifier for the Amazon Web Services account that the finding applies to. This is typically the account that owns the affected resource.

        • archived (boolean) --

          Specifies whether the finding is archived (suppressed).

        • category (string) --

          The category of the finding. Possible values are: CLASSIFICATION, for a sensitive data finding; and, POLICY, for a policy finding.

        • classificationDetails (dict) --

          The details of a sensitive data finding. This value is null for a policy finding.

          • detailedResultsLocation (string) --

            The path to the folder or file (in Amazon S3) that contains the corresponding sensitive data discovery result for the finding. If a finding applies to a large archive or compressed file, this value is the path to a folder. Otherwise, this value is the path to a file.

          • jobArn (string) --

            The Amazon Resource Name (ARN) of the classification job that produced the finding.

          • jobId (string) --

            The unique identifier for the classification job that produced the finding.

          • result (dict) --

            The status and other details of the finding.

            • additionalOccurrences (boolean) --

              Specifies whether Amazon Macie detected additional occurrences of sensitive data in the S3 object. A finding includes location data for a maximum of 15 occurrences of sensitive data.

              This value can help you determine whether to investigate additional occurrences of sensitive data in an object. You can do this by referring to the corresponding sensitive data discovery result for the finding (ClassificationDetails.detailedResultsLocation).

            • customDataIdentifiers (dict) --

              The custom data identifiers that detected the sensitive data and the number of occurrences of the data that they detected.

              • detections (list) --

                The custom data identifiers that detected the data, and the number of occurrences of the data that each identifier detected.

                • (dict) --

                  Provides information about a custom data identifier that produced a sensitive data finding, and the sensitive data that it detected for the finding.

                  • arn (string) --

                    The Amazon Resource Name (ARN) of the custom data identifier.

                  • count (integer) --

                    The total number of occurrences of the sensitive data that the custom data identifier detected.

                  • name (string) --

                    The name of the custom data identifier.

                  • occurrences (dict) --

                    The location of 1-15 occurrences of the sensitive data that the custom data identifier detected. A finding includes location data for a maximum of 15 occurrences of sensitive data.

                    • cells (list) --

                      An array of objects, one for each occurrence of sensitive data in a Microsoft Excel workbook, CSV file, or TSV file. This value is null for all other types of files.

                      Each Cell object specifies a cell or field that contains the sensitive data.

                      • (dict) --

                        Specifies the location of an occurrence of sensitive data in a Microsoft Excel workbook, CSV file, or TSV file.

                        • cellReference (string) --

                          The location of the cell, as an absolute cell reference, that contains the sensitive data, for example Sheet2!C5 for cell C5 on Sheet2 in a Microsoft Excel workbook. This value is null for CSV and TSV files.

                        • column (integer) --

                          The column number of the column that contains the sensitive data. For a Microsoft Excel workbook, this value correlates to the alphabetical character(s) for a column identifier, for example: 1 for column A, 2 for column B, and so on.

                        • columnName (string) --

                          The name of the column that contains the sensitive data, if available.

                        • row (integer) --

                          The row number of the row that contains the sensitive data.

                    • lineRanges (list) --

                      An array of objects, one for each occurrence of sensitive data in a non-binary text file, such as an HTML, TXT, or XML file. Each Range object specifies a line or inclusive range of lines that contains the sensitive data, and the position of the data on the specified line or lines.

                      This value is often null for file types that are supported by Cell, Page, or Record objects. Exceptions are the location of sensitive data in: unstructured sections of an otherwise structured file, such as a comment in a file; a malformed file that Amazon Macie analyzes as plain text; and, a CSV or TSV file that has any column names that contain sensitive data.

                      • (dict) --

                        Specifies the location of an occurrence of sensitive data in a non-binary text file, such as an HTML, TXT, or XML file.

                        • end (integer) --

                          The number of lines from the beginning of the file to the end of the sensitive data.

                        • start (integer) --

                          The number of lines from the beginning of the file to the beginning of the sensitive data.

                        • startColumn (integer) --

                          The number of characters, with spaces and starting from 1, from the beginning of the first line that contains the sensitive data (start) to the beginning of the sensitive data.

                    • offsetRanges (list) --

                      Reserved for future use.

                      • (dict) --

                        Specifies the location of an occurrence of sensitive data in a non-binary text file, such as an HTML, TXT, or XML file.

                        • end (integer) --

                          The number of lines from the beginning of the file to the end of the sensitive data.

                        • start (integer) --

                          The number of lines from the beginning of the file to the beginning of the sensitive data.

                        • startColumn (integer) --

                          The number of characters, with spaces and starting from 1, from the beginning of the first line that contains the sensitive data (start) to the beginning of the sensitive data.

                    • pages (list) --

                      An array of objects, one for each occurrence of sensitive data in an Adobe Portable Document Format file. This value is null for all other types of files.

                      Each Page object specifies a page that contains the sensitive data.

                      • (dict) --

                        Specifies the location of an occurrence of sensitive data in an Adobe Portable Document Format file.

                        • lineRange (dict) --

                          Reserved for future use.

                          • end (integer) --

                            The number of lines from the beginning of the file to the end of the sensitive data.

                          • start (integer) --

                            The number of lines from the beginning of the file to the beginning of the sensitive data.

                          • startColumn (integer) --

                            The number of characters, with spaces and starting from 1, from the beginning of the first line that contains the sensitive data (start) to the beginning of the sensitive data.

                        • offsetRange (dict) --

                          Reserved for future use.

                          • end (integer) --

                            The number of lines from the beginning of the file to the end of the sensitive data.

                          • start (integer) --

                            The number of lines from the beginning of the file to the beginning of the sensitive data.

                          • startColumn (integer) --

                            The number of characters, with spaces and starting from 1, from the beginning of the first line that contains the sensitive data (start) to the beginning of the sensitive data.

                        • pageNumber (integer) --

                          The page number of the page that contains the sensitive data.

                    • records (list) --

                      An array of objects, one for each occurrence of sensitive data in an Apache Avro object container, Apache Parquet file, JSON file, or JSON Lines file. This value is null for all other types of files.

                      For an Avro object container or Parquet file, each Record object specifies a record index and the path to a field in a record that contains the sensitive data. For a JSON or JSON Lines file, each Record object specifies the path to a field or array that contains the sensitive data. For a JSON Lines file, it also specifies the index of the line that contains the data.

                      • (dict) --

                        Specifies the location of an occurrence of sensitive data in an Apache Avro object container, Apache Parquet file, JSON file, or JSON Lines file.

                        • jsonPath (string) --

                          The path, as a JSONPath expression, to the sensitive data. For an Avro object container or Parquet file, this is the path to the field in the record (recordIndex) that contains the data. For a JSON or JSON Lines file, this is the path to the field or array that contains the data. If the data is a value in an array, the path also indicates which value contains the data.

                          If Amazon Macie detects sensitive data in the name of any element in the path, Macie omits this field. If the name of an element exceeds 20 characters, Macie truncates the name by removing characters from the beginning of the name. If the resulting full path exceeds 250 characters, Macie also truncates the path, starting with the first element in the path, until the path contains 250 or fewer characters.

                        • recordIndex (integer) --

                          For an Avro object container or Parquet file, the record index, starting from 0, for the record that contains the sensitive data. For a JSON Lines file, the line index, starting from 0, for the line that contains the sensitive data. This value is always 0 for JSON files.

              • totalCount (integer) --

                The total number of occurrences of the data that was detected by the custom data identifiers and produced the finding.

            • mimeType (string) --

              The type of content, as a MIME type, that the finding applies to. For example, application/gzip, for a GNU Gzip compressed archive file, or application/pdf, for an Adobe Portable Document Format file.

            • sensitiveData (list) --

              The category, types, and number of occurrences of the sensitive data that produced the finding.

              • (dict) --

                Provides information about the category, types, and occurrences of sensitive data that produced a sensitive data finding.

                • category (string) --

                  The category of sensitive data that was detected. For example: CREDENTIALS, for credentials data such as private keys or Amazon Web Services secret keys; FINANCIAL_INFORMATION, for financial data such as credit card numbers; or, PERSONAL_INFORMATION, for personal health information, such as health insurance identification numbers, or personally identifiable information, such as passport numbers.

                • detections (list) --

                  An array of objects, one for each type of sensitive data that was detected. Each object reports the number of occurrences of a specific type of sensitive data that was detected, and the location of up to 15 of those occurrences.

                  • (dict) --

                    Provides information about a type of sensitive data that was detected by a managed data identifier and produced a sensitive data finding.

                    • count (integer) --

                      The total number of occurrences of the type of sensitive data that was detected.

                    • occurrences (dict) --

                      The location of 1-15 occurrences of the sensitive data that was detected. A finding includes location data for a maximum of 15 occurrences of sensitive data.

                      • cells (list) --

                        An array of objects, one for each occurrence of sensitive data in a Microsoft Excel workbook, CSV file, or TSV file. This value is null for all other types of files.

                        Each Cell object specifies a cell or field that contains the sensitive data.

                        • (dict) --

                          Specifies the location of an occurrence of sensitive data in a Microsoft Excel workbook, CSV file, or TSV file.

                          • cellReference (string) --

                            The location of the cell, as an absolute cell reference, that contains the sensitive data, for example Sheet2!C5 for cell C5 on Sheet2 in a Microsoft Excel workbook. This value is null for CSV and TSV files.

                          • column (integer) --

                            The column number of the column that contains the sensitive data. For a Microsoft Excel workbook, this value correlates to the alphabetical character(s) for a column identifier, for example: 1 for column A, 2 for column B, and so on.

                          • columnName (string) --

                            The name of the column that contains the sensitive data, if available.

                          • row (integer) --

                            The row number of the row that contains the sensitive data.

                      • lineRanges (list) --

                        An array of objects, one for each occurrence of sensitive data in a non-binary text file, such as an HTML, TXT, or XML file. Each Range object specifies a line or inclusive range of lines that contains the sensitive data, and the position of the data on the specified line or lines.

                        This value is often null for file types that are supported by Cell, Page, or Record objects. Exceptions are the location of sensitive data in: unstructured sections of an otherwise structured file, such as a comment in a file; a malformed file that Amazon Macie analyzes as plain text; and, a CSV or TSV file that has any column names that contain sensitive data.

                        • (dict) --

                          Specifies the location of an occurrence of sensitive data in a non-binary text file, such as an HTML, TXT, or XML file.

                          • end (integer) --

                            The number of lines from the beginning of the file to the end of the sensitive data.

                          • start (integer) --

                            The number of lines from the beginning of the file to the beginning of the sensitive data.

                          • startColumn (integer) --

                            The number of characters, with spaces and starting from 1, from the beginning of the first line that contains the sensitive data (start) to the beginning of the sensitive data.

                      • offsetRanges (list) --

                        Reserved for future use.

                        • (dict) --

                          Specifies the location of an occurrence of sensitive data in a non-binary text file, such as an HTML, TXT, or XML file.

                          • end (integer) --

                            The number of lines from the beginning of the file to the end of the sensitive data.

                          • start (integer) --

                            The number of lines from the beginning of the file to the beginning of the sensitive data.

                          • startColumn (integer) --

                            The number of characters, with spaces and starting from 1, from the beginning of the first line that contains the sensitive data (start) to the beginning of the sensitive data.

                      • pages (list) --

                        An array of objects, one for each occurrence of sensitive data in an Adobe Portable Document Format file. This value is null for all other types of files.

                        Each Page object specifies a page that contains the sensitive data.

                        • (dict) --

                          Specifies the location of an occurrence of sensitive data in an Adobe Portable Document Format file.

                          • lineRange (dict) --

                            Reserved for future use.

                            • end (integer) --

                              The number of lines from the beginning of the file to the end of the sensitive data.

                            • start (integer) --

                              The number of lines from the beginning of the file to the beginning of the sensitive data.

                            • startColumn (integer) --

                              The number of characters, with spaces and starting from 1, from the beginning of the first line that contains the sensitive data (start) to the beginning of the sensitive data.

                          • offsetRange (dict) --

                            Reserved for future use.

                            • end (integer) --

                              The number of lines from the beginning of the file to the end of the sensitive data.

                            • start (integer) --

                              The number of lines from the beginning of the file to the beginning of the sensitive data.

                            • startColumn (integer) --

                              The number of characters, with spaces and starting from 1, from the beginning of the first line that contains the sensitive data (start) to the beginning of the sensitive data.

                          • pageNumber (integer) --

                            The page number of the page that contains the sensitive data.

                      • records (list) --

                        An array of objects, one for each occurrence of sensitive data in an Apache Avro object container, Apache Parquet file, JSON file, or JSON Lines file. This value is null for all other types of files.

                        For an Avro object container or Parquet file, each Record object specifies a record index and the path to a field in a record that contains the sensitive data. For a JSON or JSON Lines file, each Record object specifies the path to a field or array that contains the sensitive data. For a JSON Lines file, it also specifies the index of the line that contains the data.

                        • (dict) --

                          Specifies the location of an occurrence of sensitive data in an Apache Avro object container, Apache Parquet file, JSON file, or JSON Lines file.

                          • jsonPath (string) --

                            The path, as a JSONPath expression, to the sensitive data. For an Avro object container or Parquet file, this is the path to the field in the record (recordIndex) that contains the data. For a JSON or JSON Lines file, this is the path to the field or array that contains the data. If the data is a value in an array, the path also indicates which value contains the data.

                            If Amazon Macie detects sensitive data in the name of any element in the path, Macie omits this field. If the name of an element exceeds 20 characters, Macie truncates the name by removing characters from the beginning of the name. If the resulting full path exceeds 250 characters, Macie also truncates the path, starting with the first element in the path, until the path contains 250 or fewer characters.

                          • recordIndex (integer) --

                            For an Avro object container or Parquet file, the record index, starting from 0, for the record that contains the sensitive data. For a JSON Lines file, the line index, starting from 0, for the line that contains the sensitive data. This value is always 0 for JSON files.

                    • type (string) --

                      The type of sensitive data that was detected. For example, AWS_CREDENTIALS, PHONE_NUMBER, or ADDRESS.

                • totalCount (integer) --

                  The total number of occurrences of the sensitive data that was detected.

            • sizeClassified (integer) --

              The total size, in bytes, of the data that the finding applies to.

            • status (dict) --

              The status of the finding.

              • code (string) --

                The status of the finding. Possible values are:

                • COMPLETE - Amazon Macie successfully completed its analysis of the S3 object that the finding applies to.
                • PARTIAL - Macie analyzed only a subset of the data in the S3 object that the finding applies to. For example, the object is an archive file that contains files in an unsupported format.
                • SKIPPED - Macie wasn't able to analyze the S3 object that the finding applies to. For example, the object is a file in an unsupported format.
              • reason (string) --

                A brief description of the status of the finding. Amazon Macie uses this value to notify you of any errors, warnings, or considerations that might impact your analysis of the finding.

        • count (integer) --

          The total number of occurrences of the finding. For sensitive data findings, this value is always 1. All sensitive data findings are considered new (unique) because they derive from individual classification jobs.

        • createdAt (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when the finding was created.

        • description (string) --

          The description of the finding.

        • id (string) --

          The unique identifier for the finding. This is a random string that Amazon Macie generates and assigns to a finding when it creates the finding.

        • partition (string) --

          The Amazon Web Services partition that Amazon Macie created the finding in.

        • policyDetails (dict) --

          The details of a policy finding. This value is null for a sensitive data finding.

          • action (dict) --

            The action that produced the finding.

            • actionType (string) --

              The type of action that occurred for the affected resource. This value is typically AWS_API_CALL, which indicates that an entity invoked an API operation for the resource.

            • apiCallDetails (dict) --

              The invocation details of the API operation that an entity invoked for the affected resource, if the value for the actionType property is AWS_API_CALL.

              • api (string) --

                The name of the operation that was invoked most recently and produced the finding.

              • apiServiceName (string) --

                The URL of the Amazon Web Service that provides the operation, for example: s3.amazonaws.com.

              • firstSeen (datetime) --

                The first date and time, in UTC and extended ISO 8601 format, when any operation was invoked and produced the finding.

              • lastSeen (datetime) --

                The most recent date and time, in UTC and extended ISO 8601 format, when the specified operation (api) was invoked and produced the finding.

          • actor (dict) --

            The entity that performed the action that produced the finding.

            • domainDetails (dict) --

              The domain name of the device that the entity used to perform the action on the affected resource.

              • domainName (string) --

                The name of the domain.

            • ipAddressDetails (dict) --

              The IP address of the device that the entity used to perform the action on the affected resource. This object also provides information such as the owner and geographic location for the IP address.

              • ipAddressV4 (string) --

                The Internet Protocol version 4 (IPv4) address of the device.

              • ipCity (dict) --

                The city that the IP address originated from.

                • name (string) --

                  The name of the city.

              • ipCountry (dict) --

                The country that the IP address originated from.

                • code (string) --

                  The two-character code, in ISO 3166-1 alpha-2 format, for the country that the IP address originated from. For example, US for the United States.

                • name (string) --

                  The name of the country that the IP address originated from.

              • ipGeoLocation (dict) --

                The geographic coordinates of the location that the IP address originated from.

                • lat (float) --

                  The latitude coordinate of the location, rounded to four decimal places.

                • lon (float) --

                  The longitude coordinate of the location, rounded to four decimal places.

              • ipOwner (dict) --

                The registered owner of the IP address.

                • asn (string) --

                  The autonomous system number (ASN) for the autonomous system that included the IP address.

                • asnOrg (string) --

                  The organization identifier that's associated with the autonomous system number (ASN) for the autonomous system that included the IP address.

                • isp (string) --

                  The name of the internet service provider (ISP) that owned the IP address.

                • org (string) --

                  The name of the organization that owned the IP address.

            • userIdentity (dict) --

              The type and other characteristics of the entity that performed the action on the affected resource.

              • assumedRole (dict) --

                If the action was performed with temporary security credentials that were obtained using the AssumeRole operation of the Security Token Service (STS) API, the identifiers, session context, and other details about the identity.

                • accessKeyId (string) --

                  The Amazon Web Services access key ID that identifies the credentials.

                • accountId (string) --

                  The unique identifier for the Amazon Web Services account that owns the entity that was used to get the credentials.

                • arn (string) --

                  The Amazon Resource Name (ARN) of the entity that was used to get the credentials.

                • principalId (string) --

                  The unique identifier for the entity that was used to get the credentials.

                • sessionContext (dict) --

                  The details of the session that was created for the credentials, including the entity that issued the session.

                  • attributes (dict) --

                    The date and time when the credentials were issued, and whether the credentials were authenticated with a multi-factor authentication (MFA) device.

                    • creationDate (datetime) --

                      The date and time, in UTC and ISO 8601 format, when the credentials were issued.

                    • mfaAuthenticated (boolean) --

                      Specifies whether the credentials were authenticated with a multi-factor authentication (MFA) device.

                  • sessionIssuer (dict) --

                    The source and type of credentials that were issued to the entity.

                    • accountId (string) --

                      The unique identifier for the Amazon Web Services account that owns the entity that was used to get the credentials.

                    • arn (string) --

                      The Amazon Resource Name (ARN) of the source account, IAM user, or role that was used to get the credentials.

                    • principalId (string) --

                      The unique identifier for the entity that was used to get the credentials.

                    • type (string) --

                      The source of the temporary security credentials, such as Root, IAMUser, or Role.

                    • userName (string) --

                      The name or alias of the user or role that issued the session. This value is null if the credentials were obtained from a root account that doesn't have an alias.

              • awsAccount (dict) --

                If the action was performed using the credentials for another Amazon Web Services account, the details of that account.

                • accountId (string) --

                  The unique identifier for the Amazon Web Services account.

                • principalId (string) --

                  The unique identifier for the entity that performed the action.

              • awsService (dict) --

                If the action was performed by an Amazon Web Services account that belongs to an Amazon Web Service, the name of the service.

                • invokedBy (string) --

                  The name of the Amazon Web Service that performed the action.

              • federatedUser (dict) --

                If the action was performed with temporary security credentials that were obtained using the GetFederationToken operation of the Security Token Service (STS) API, the identifiers, session context, and other details about the identity.

                • accessKeyId (string) --

                  The Amazon Web Services access key ID that identifies the credentials.

                • accountId (string) --

                  The unique identifier for the Amazon Web Services account that owns the entity that was used to get the credentials.

                • arn (string) --

                  The Amazon Resource Name (ARN) of the entity that was used to get the credentials.

                • principalId (string) --

                  The unique identifier for the entity that was used to get the credentials.

                • sessionContext (dict) --

                  The details of the session that was created for the credentials, including the entity that issued the session.

                  • attributes (dict) --

                    The date and time when the credentials were issued, and whether the credentials were authenticated with a multi-factor authentication (MFA) device.

                    • creationDate (datetime) --

                      The date and time, in UTC and ISO 8601 format, when the credentials were issued.

                    • mfaAuthenticated (boolean) --

                      Specifies whether the credentials were authenticated with a multi-factor authentication (MFA) device.

                  • sessionIssuer (dict) --

                    The source and type of credentials that were issued to the entity.

                    • accountId (string) --

                      The unique identifier for the Amazon Web Services account that owns the entity that was used to get the credentials.

                    • arn (string) --

                      The Amazon Resource Name (ARN) of the source account, IAM user, or role that was used to get the credentials.

                    • principalId (string) --

                      The unique identifier for the entity that was used to get the credentials.

                    • type (string) --

                      The source of the temporary security credentials, such as Root, IAMUser, or Role.

                    • userName (string) --

                      The name or alias of the user or role that issued the session. This value is null if the credentials were obtained from a root account that doesn't have an alias.

              • iamUser (dict) --

                If the action was performed using the credentials for an Identity and Access Management (IAM) user, the name and other details about the user.

                • accountId (string) --

                  The unique identifier for the Amazon Web Services account that's associated with the IAM user who performed the action.

                • arn (string) --

                  The Amazon Resource Name (ARN) of the principal that performed the action. The last section of the ARN contains the name of the user who performed the action.

                • principalId (string) --

                  The unique identifier for the IAM user who performed the action.

                • userName (string) --

                  The user name of the IAM user who performed the action.

              • root (dict) --

                If the action was performed using the credentials for your Amazon Web Services account, the details of your account.

                • accountId (string) --

                  The unique identifier for the Amazon Web Services account.

                • arn (string) --

                  The Amazon Resource Name (ARN) of the principal that performed the action. The last section of the ARN contains the name of the user or role that performed the action.

                • principalId (string) --

                  The unique identifier for the entity that performed the action.

              • type (string) --

                The type of entity that performed the action.

        • region (string) --

          The Amazon Web Services Region that Amazon Macie created the finding in.

        • resourcesAffected (dict) --

          The resources that the finding applies to.

          • s3Bucket (dict) --

            The details of the S3 bucket that the finding applies to.

            • allowsUnencryptedObjectUploads (string) --

              Specifies whether the bucket policy for the bucket requires server-side encryption of objects when objects are uploaded to the bucket. Possible values are:

              • FALSE - The bucket policy requires server-side encryption of new objects. PutObject requests must include the x-amz-server-side-encryption header and the value for that header must be AES256 or aws:kms.
              • TRUE - The bucket doesn't have a bucket policy or it has a bucket policy that doesn't require server-side encryption of new objects. If a bucket policy exists, it doesn't require PutObject requests to include the x-amz-server-side-encryption header and it doesn't require the value for that header to be AES256 or aws:kms.
              • UNKNOWN - Amazon Macie can't determine whether the bucket policy requires server-side encryption of objects.
            • arn (string) --

              The Amazon Resource Name (ARN) of the bucket.

            • createdAt (datetime) --

              The date and time, in UTC and extended ISO 8601 format, when the bucket was created.

            • defaultServerSideEncryption (dict) --

              The type of server-side encryption that's used by default to encrypt objects in the bucket.

              • encryptionType (string) --

                The server-side encryption algorithm that's used when storing data in the bucket or object. If default encryption is disabled for the bucket or the object isn't encrypted using server-side encryption, this value is NONE.

              • kmsMasterKeyId (string) --

                The Amazon Resource Name (ARN) or unique identifier (key ID) for the KMS key that's used to encrypt data in the bucket or the object. This value is null if an KMS key isn't used to encrypt the data.

            • name (string) --

              The name of the bucket.

            • owner (dict) --

              The display name and canonical user ID for the Amazon Web Services account that owns the bucket.

              • displayName (string) --

                The display name of the account that owns the bucket.

              • id (string) --

                The canonical user ID for the account that owns the bucket.

            • publicAccess (dict) --

              The permissions settings that determine whether the bucket is publicly accessible.

              • effectivePermission (string) --

                Specifies whether the bucket is publicly accessible due to the combination of permissions settings that apply to the bucket. Possible values are:

                • NOT_PUBLIC - The bucket isn't publicly accessible.
                • PUBLIC - The bucket is publicly accessible.
                • UNKNOWN - Amazon Macie can't determine whether the bucket is publicly accessible.
              • permissionConfiguration (dict) --

                The account-level and bucket-level permissions settings for the bucket.

                • accountLevelPermissions (dict) --

                  The account-level permissions settings that apply to the bucket.

                  • blockPublicAccess (dict) --

                    The block public access settings for the Amazon Web Services account that owns the bucket.

                    • blockPublicAcls (boolean) --

                      Specifies whether Amazon S3 blocks public access control lists (ACLs) for the bucket and objects in the bucket.

                    • blockPublicPolicy (boolean) --

                      Specifies whether Amazon S3 blocks public bucket policies for the bucket.

                    • ignorePublicAcls (boolean) --

                      Specifies whether Amazon S3 ignores public ACLs for the bucket and objects in the bucket.

                    • restrictPublicBuckets (boolean) --

                      Specifies whether Amazon S3 restricts public bucket policies for the bucket.

                • bucketLevelPermissions (dict) --

                  The bucket-level permissions settings for the bucket.

                  • accessControlList (dict) --

                    The permissions settings of the access control list (ACL) for the bucket. This value is null if an ACL hasn't been defined for the bucket.

                    • allowsPublicReadAccess (boolean) --

                      Specifies whether the ACL grants the general public with read access permissions for the bucket.

                    • allowsPublicWriteAccess (boolean) --

                      Specifies whether the ACL grants the general public with write access permissions for the bucket.

                  • blockPublicAccess (dict) --

                    The block public access settings for the bucket.

                    • blockPublicAcls (boolean) --

                      Specifies whether Amazon S3 blocks public access control lists (ACLs) for the bucket and objects in the bucket.

                    • blockPublicPolicy (boolean) --

                      Specifies whether Amazon S3 blocks public bucket policies for the bucket.

                    • ignorePublicAcls (boolean) --

                      Specifies whether Amazon S3 ignores public ACLs for the bucket and objects in the bucket.

                    • restrictPublicBuckets (boolean) --

                      Specifies whether Amazon S3 restricts public bucket policies for the bucket.

                  • bucketPolicy (dict) --

                    The permissions settings of the bucket policy for the bucket. This value is null if a bucket policy hasn't been defined for the bucket.

                    • allowsPublicReadAccess (boolean) --

                      Specifies whether the bucket policy allows the general public to have read access to the bucket.

                    • allowsPublicWriteAccess (boolean) --

                      Specifies whether the bucket policy allows the general public to have write access to the bucket.

            • tags (list) --

              The tags that are associated with the bucket.

              • (dict) --

                Provides information about the tags that are associated with an S3 bucket or object. Each tag consists of a required tag key and an associated tag value.

                • key (string) --

                  One part of a key-value pair that comprises a tag. A tag key is a general label that acts as a category for more specific tag values.

                • value (string) --

                  One part of a key-value pair that comprises a tag. A tag value acts as a descriptor for a tag key. A tag value can be an empty string.

          • s3Object (dict) --

            The details of the S3 object that the finding applies to.

            • bucketArn (string) --

              The Amazon Resource Name (ARN) of the bucket that contains the object.

            • eTag (string) --

              The entity tag (ETag) that identifies the affected version of the object. If the object was overwritten or changed after Amazon Macie produced the finding, this value might be different from the current ETag for the object.

            • extension (string) --

              The file name extension of the object. If the object doesn't have a file name extension, this value is "".

            • key (string) --

              The full key (name) that's assigned to the object.

            • lastModified (datetime) --

              The date and time, in UTC and extended ISO 8601 format, when the object was last modified.

            • path (string) --

              The path to the object, including the full key (name).

            • publicAccess (boolean) --

              Specifies whether the object is publicly accessible due to the combination of permissions settings that apply to the object.

            • serverSideEncryption (dict) --

              The type of server-side encryption that's used to encrypt the object.

              • encryptionType (string) --

                The server-side encryption algorithm that's used when storing data in the bucket or object. If default encryption is disabled for the bucket or the object isn't encrypted using server-side encryption, this value is NONE.

              • kmsMasterKeyId (string) --

                The Amazon Resource Name (ARN) or unique identifier (key ID) for the KMS key that's used to encrypt data in the bucket or the object. This value is null if an KMS key isn't used to encrypt the data.

            • size (integer) --

              The total storage size, in bytes, of the object.

            • storageClass (string) --

              The storage class of the object.

            • tags (list) --

              The tags that are associated with the object.

              • (dict) --

                Provides information about the tags that are associated with an S3 bucket or object. Each tag consists of a required tag key and an associated tag value.

                • key (string) --

                  One part of a key-value pair that comprises a tag. A tag key is a general label that acts as a category for more specific tag values.

                • value (string) --

                  One part of a key-value pair that comprises a tag. A tag value acts as a descriptor for a tag key. A tag value can be an empty string.

            • versionId (string) --

              The identifier for the affected version of the object.

        • sample (boolean) --

          Specifies whether the finding is a sample finding. A sample finding is a finding that uses example data to demonstrate what a finding might contain.

        • schemaVersion (string) --

          The version of the schema that was used to define the data structures in the finding.

        • severity (dict) --

          The severity level and score for the finding.

          • description (string) --

            The qualitative representation of the finding's severity, ranging from Low (least severe) to High (most severe).

          • score (integer) --

            The numerical representation of the finding's severity, ranging from 1 (least severe) to 3 (most severe).

        • title (string) --

          The brief description of the finding.

        • type (string) --

          The type of the finding.

        • updatedAt (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when the finding was last updated. For sensitive data findings, this value is the same as the value for the createdAt property. All sensitive data findings are considered new (unique) because they derive from individual classification jobs.

Exceptions

get_findings_filter(**kwargs)

Retrieves the criteria and other settings for a findings filter.

See also: AWS API Documentation

Request Syntax

response = client.get_findings_filter(
    id='string'
)
Parameters
id (string) --

[REQUIRED]

The unique identifier for the Amazon Macie resource or account that the request applies to.

Return type
dict
Returns
Response Syntax
{
    'action': 'ARCHIVE'|'NOOP',
    'arn': 'string',
    'description': 'string',
    'findingCriteria': {
        'criterion': {
            'string': {
                'eq': [
                    'string',
                ],
                'eqExactMatch': [
                    'string',
                ],
                'gt': 123,
                'gte': 123,
                'lt': 123,
                'lte': 123,
                'neq': [
                    'string',
                ]
            }
        }
    },
    'id': 'string',
    'name': 'string',
    'position': 123,
    'tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    The request succeeded.

    • action (string) --

      The action that's performed on findings that meet the filter criteria (findingCriteria). Possible values are: ARCHIVE, suppress (automatically archive) the findings; and, NOOP, don't perform any action on the findings.

    • arn (string) --

      The Amazon Resource Name (ARN) of the filter.

    • description (string) --

      The custom description of the filter.

    • findingCriteria (dict) --

      The criteria that's used to filter findings.

      • criterion (dict) --

        A condition that specifies the property, operator, and one or more values to use to filter the results.

        • (string) --
          • (dict) --

            Specifies the operator to use in a property-based condition that filters the results of a query for findings. For detailed information and examples of each operator, see Fundamentals of filtering findings in the Amazon Macie User Guide .

            • eq (list) --

              The value for the property matches (equals) the specified value. If you specify multiple values, Macie uses OR logic to join the values.

              • (string) --
            • eqExactMatch (list) --

              The value for the property exclusively matches (equals an exact match for) all the specified values. If you specify multiple values, Amazon Macie uses AND logic to join the values.

              You can use this operator with the following properties: customDataIdentifiers.detections.arn, customDataIdentifiers.detections.name, resourcesAffected.s3Bucket.tags.key, resourcesAffected.s3Bucket.tags.value, resourcesAffected.s3Object.tags.key, resourcesAffected.s3Object.tags.value, sensitiveData.category, and sensitiveData.detections.type.

              • (string) --
            • gt (integer) --

              The value for the property is greater than the specified value.

            • gte (integer) --

              The value for the property is greater than or equal to the specified value.

            • lt (integer) --

              The value for the property is less than the specified value.

            • lte (integer) --

              The value for the property is less than or equal to the specified value.

            • neq (list) --

              The value for the property doesn't match (doesn't equal) the specified value. If you specify multiple values, Macie uses OR logic to join the values.

              • (string) --
    • id (string) --

      The unique identifier for the filter.

    • name (string) --

      The custom name of the filter.

    • position (integer) --

      The position of the filter in the list of saved filters on the Amazon Macie console. This value also determines the order in which the filter is applied to findings, relative to other filters that are also applied to the findings.

    • tags (dict) --

      A map of key-value pairs that identifies the tags (keys and values) that are associated with the filter.

      • (string) --
        • (string) --

Exceptions

get_findings_publication_configuration()

Retrieves the configuration settings for publishing findings to Security Hub.

See also: AWS API Documentation

Request Syntax

response = client.get_findings_publication_configuration()
Return type
dict
Returns
Response Syntax
{
    'securityHubConfiguration': {
        'publishClassificationFindings': True|False,
        'publishPolicyFindings': True|False
    }
}

Response Structure

  • (dict) --

    The request succeeded.

    • securityHubConfiguration (dict) --

      The configuration settings that determine which findings are published to Security Hub.

      • publishClassificationFindings (boolean) --

        Specifies whether to publish sensitive data findings to Security Hub. If you set this value to true, Amazon Macie automatically publishes all sensitive data findings that weren't suppressed by a findings filter. The default value is false.

      • publishPolicyFindings (boolean) --

        Specifies whether to publish policy findings to Security Hub. If you set this value to true, Amazon Macie automatically publishes all new and updated policy findings that weren't suppressed by a findings filter. The default value is true.

Exceptions

get_invitations_count()

Retrieves the count of Amazon Macie membership invitations that were received by an account.

See also: AWS API Documentation

Request Syntax

response = client.get_invitations_count()
Return type
dict
Returns
Response Syntax
{
    'invitationsCount': 123
}

Response Structure

  • (dict) --

    The request succeeded.

    • invitationsCount (integer) --

      The total number of invitations that were received by the account, not including the currently accepted invitation.

Exceptions

get_macie_session()

Retrieves the current status and configuration settings for an Amazon Macie account.

See also: AWS API Documentation

Request Syntax

response = client.get_macie_session()
Return type
dict
Returns
Response Syntax
{
    'createdAt': datetime(2015, 1, 1),
    'findingPublishingFrequency': 'FIFTEEN_MINUTES'|'ONE_HOUR'|'SIX_HOURS',
    'serviceRole': 'string',
    'status': 'PAUSED'|'ENABLED',
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    The request succeeded.

    • createdAt (datetime) --

      The date and time, in UTC and extended ISO 8601 format, when the Amazon Macie account was created.

    • findingPublishingFrequency (string) --

      The frequency with which Macie publishes updates to policy findings for the account. This includes publishing updates to Security Hub and Amazon EventBridge (formerly called Amazon CloudWatch Events).

    • serviceRole (string) --

      The Amazon Resource Name (ARN) of the service-linked role that allows Macie to monitor and analyze data in Amazon Web Services resources for the account.

    • status (string) --

      The current status of the Macie account. Possible values are: PAUSED, the account is enabled but all Macie activities are suspended (paused) for the account; and, ENABLED, the account is enabled and all Macie activities are enabled for the account.

    • updatedAt (datetime) --

      The date and time, in UTC and extended ISO 8601 format, of the most recent change to the status of the Macie account.

Exceptions

get_master_account()

(Deprecated) Retrieves information about the Amazon Macie administrator account for an account. This operation has been replaced by the GetAdministratorAccountoperation.

See also: AWS API Documentation

Request Syntax

response = client.get_master_account()
Return type
dict
Returns
Response Syntax
{
    'master': {
        'accountId': 'string',
        'invitationId': 'string',
        'invitedAt': datetime(2015, 1, 1),
        'relationshipStatus': 'Enabled'|'Paused'|'Invited'|'Created'|'Removed'|'Resigned'|'EmailVerificationInProgress'|'EmailVerificationFailed'|'RegionDisabled'|'AccountSuspended'
    }
}

Response Structure

  • (dict) --

    The request succeeded.

    • master (dict) --

      (Deprecated) The Amazon Web Services account ID for the administrator account. If the accounts are associated by a Macie membership invitation, this object also provides details about the invitation that was sent to establish the relationship between the accounts.

      • accountId (string) --

        The Amazon Web Services account ID for the account that sent the invitation.

      • invitationId (string) --

        The unique identifier for the invitation. Amazon Macie uses this identifier to validate the inviter account with the invitee account.

      • invitedAt (datetime) --

        The date and time, in UTC and extended ISO 8601 format, when the invitation was sent.

      • relationshipStatus (string) --

        The status of the relationship between the account that sent the invitation (inviter account ) and the account that received the invitation (invitee account ).

Exceptions

get_member(**kwargs)

Retrieves information about an account that's associated with an Amazon Macie administrator account.

See also: AWS API Documentation

Request Syntax

response = client.get_member(
    id='string'
)
Parameters
id (string) --

[REQUIRED]

The unique identifier for the Amazon Macie resource or account that the request applies to.

Return type
dict
Returns
Response Syntax
{
    'accountId': 'string',
    'administratorAccountId': 'string',
    'arn': 'string',
    'email': 'string',
    'invitedAt': datetime(2015, 1, 1),
    'masterAccountId': 'string',
    'relationshipStatus': 'Enabled'|'Paused'|'Invited'|'Created'|'Removed'|'Resigned'|'EmailVerificationInProgress'|'EmailVerificationFailed'|'RegionDisabled'|'AccountSuspended',
    'tags': {
        'string': 'string'
    },
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    The request succeeded.

    • accountId (string) --

      The Amazon Web Services account ID for the account.

    • administratorAccountId (string) --

      The Amazon Web Services account ID for the administrator account.

    • arn (string) --

      The Amazon Resource Name (ARN) of the account.

    • email (string) --

      The email address for the account.

    • invitedAt (datetime) --

      The date and time, in UTC and extended ISO 8601 format, when an Amazon Macie membership invitation was last sent to the account. This value is null if a Macie invitation hasn't been sent to the account.

    • masterAccountId (string) --

      (Deprecated) The Amazon Web Services account ID for the administrator account. This property has been replaced by the administratorAccountId property and is retained only for backward compatibility.

    • relationshipStatus (string) --

      The current status of the relationship between the account and the administrator account.

    • tags (dict) --

      A map of key-value pairs that identifies the tags (keys and values) that are associated with the member account in Amazon Macie.

      • (string) --
        • (string) --
    • updatedAt (datetime) --

      The date and time, in UTC and extended ISO 8601 format, of the most recent change to the status of the relationship between the account and the administrator account.

Exceptions

get_paginator(operation_name)

Create a paginator for an operation.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Raises OperationNotPageableError
Raised if the operation is not pageable. You can use the client.can_paginate method to check if an operation is pageable.
Return type
L{botocore.paginate.Paginator}
Returns
A paginator object.
get_usage_statistics(**kwargs)

Retrieves (queries) quotas and aggregated usage data for one or more accounts.

See also: AWS API Documentation

Request Syntax

response = client.get_usage_statistics(
    filterBy=[
        {
            'comparator': 'GT'|'GTE'|'LT'|'LTE'|'EQ'|'NE'|'CONTAINS',
            'key': 'accountId'|'serviceLimit'|'freeTrialStartDate'|'total',
            'values': [
                'string',
            ]
        },
    ],
    maxResults=123,
    nextToken='string',
    sortBy={
        'key': 'accountId'|'total'|'serviceLimitValue'|'freeTrialStartDate',
        'orderBy': 'ASC'|'DESC'
    },
    timeRange='MONTH_TO_DATE'|'PAST_30_DAYS'
)
Parameters
  • filterBy (list) --

    An array of objects, one for each condition to use to filter the query results. If you specify more than one condition, Amazon Macie uses an AND operator to join the conditions.

    • (dict) --

      Specifies a condition for filtering the results of a query for quota and usage data for one or more Amazon Macie accounts.

      • comparator (string) --

        The operator to use in the condition. If the value for the key property is accountId, this value must be CONTAINS. If the value for the key property is any other supported field, this value can be EQ, GT, GTE, LT, LTE, or NE.

      • key (string) --

        The field to use in the condition.

      • values (list) --

        An array that lists values to use in the condition, based on the value for the field specified by the key property. If the value for the key property is accountId, this array can specify multiple values. Otherwise, this array can specify only one value.

        Valid values for each supported field are:

        • accountId - The unique identifier for an Amazon Web Services account.
        • freeTrialStartDate - The date and time, in UTC and extended ISO 8601 format, when the free trial started for an account.
        • serviceLimit - A Boolean (true or false) value that indicates whether an account has reached its monthly quota.
        • total - A string that represents the current estimated cost for an account.
        • (string) --
  • maxResults (integer) -- The maximum number of items to include in each page of the response.
  • nextToken (string) -- The nextToken string that specifies which page of results to return in a paginated response.
  • sortBy (dict) --

    The criteria to use to sort the query results.

    • key (string) --

      The field to sort the results by.

    • orderBy (string) --

      The sort order to apply to the results, based on the value for the field specified by the key property. Valid values are: ASC, sort the results in ascending order; and, DESC, sort the results in descending order.

  • timeRange (string) -- The inclusive time period to query usage data for. Valid values are: MONTH_TO_DATE, for the current calendar month to date; and, PAST_30_DAYS, for the preceding 30 days. If you don't specify a value, Amazon Macie provides usage data for the preceding 30 days.
Return type

dict

Returns

Response Syntax

{
    'nextToken': 'string',
    'records': [
        {
            'accountId': 'string',
            'freeTrialStartDate': datetime(2015, 1, 1),
            'usage': [
                {
                    'currency': 'USD',
                    'estimatedCost': 'string',
                    'serviceLimit': {
                        'isServiceLimited': True|False,
                        'unit': 'TERABYTES',
                        'value': 123
                    },
                    'type': 'DATA_INVENTORY_EVALUATION'|'SENSITIVE_DATA_DISCOVERY'
                },
            ]
        },
    ],
    'timeRange': 'MONTH_TO_DATE'|'PAST_30_DAYS'
}

Response Structure

  • (dict) --

    The request succeeded.

    • nextToken (string) --

      The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.

    • records (list) --

      An array of objects that contains the results of the query. Each object contains the data for an account that meets the filter criteria specified in the request.

      • (dict) --

        Provides quota and aggregated usage data for an Amazon Macie account.

        • accountId (string) --

          The unique identifier for the Amazon Web Services account that the data applies to.

        • freeTrialStartDate (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when the free trial started for the account.

        • usage (list) --

          An array of objects that contains usage data and quotas for the account. Each object contains the data for a specific usage metric and the corresponding quota.

          • (dict) --

            Provides data for a specific usage metric and the corresponding quota for an Amazon Macie account.

            • currency (string) --

              The type of currency that the value for the metric (estimatedCost) is reported in.

            • estimatedCost (string) --

              The estimated value for the metric.

            • serviceLimit (dict) --

              The current value for the quota that corresponds to the metric specified by the type field.

              • isServiceLimited (boolean) --

                Specifies whether the account has met the quota that corresponds to the metric specified by the UsageByAccount.type field in the response.

              • unit (string) --

                The unit of measurement for the value specified by the value field.

              • value (integer) --

                The value for the metric specified by the UsageByAccount.type field in the response.

            • type (string) --

              The name of the metric. Possible values are: DATA_INVENTORY_EVALUATION, for monitoring S3 buckets; and, SENSITIVE_DATA_DISCOVERY, for analyzing S3 objects to detect sensitive data.

    • timeRange (string) --

      The inclusive time period that the usage data applies to. Possible values are: MONTH_TO_DATE, for the current calendar month to date; and, PAST_30_DAYS, for the preceding 30 days.

Exceptions

get_usage_totals(**kwargs)

Retrieves (queries) aggregated usage data for an account.

See also: AWS API Documentation

Request Syntax

response = client.get_usage_totals(
    timeRange='string'
)
Parameters
timeRange (string) -- The inclusive time period to retrieve the data for. Valid values are: MONTH_TO_DATE, for the current calendar month to date; and, PAST_30_DAYS, for the preceding 30 days. If you don't specify a value for this parameter, Amazon Macie provides aggregated usage data for the preceding 30 days.
Return type
dict
Returns
Response Syntax
{
    'timeRange': 'MONTH_TO_DATE'|'PAST_30_DAYS',
    'usageTotals': [
        {
            'currency': 'USD',
            'estimatedCost': 'string',
            'type': 'DATA_INVENTORY_EVALUATION'|'SENSITIVE_DATA_DISCOVERY'
        },
    ]
}

Response Structure

  • (dict) --

    The request succeeded.

    • timeRange (string) --

      The inclusive time period that the usage data applies to. Possible values are: MONTH_TO_DATE, for the current calendar month to date; and, PAST_30_DAYS, for the preceding 30 days.

    • usageTotals (list) --

      An array of objects that contains the results of the query. Each object contains the data for a specific usage metric.

      • (dict) --

        Provides aggregated data for an Amazon Macie usage metric. The value for the metric reports estimated usage data for an account for the preceding 30 days or the current calendar month to date, depending on the time period (timeRange) specified in the request.

        • currency (string) --

          The type of currency that the value for the metric (estimatedCost) is reported in.

        • estimatedCost (string) --

          The estimated value for the metric.

        • type (string) --

          The name of the metric. Possible values are: DATA_INVENTORY_EVALUATION, for monitoring S3 buckets; and, SENSITIVE_DATA_DISCOVERY, for analyzing S3 objects to detect sensitive data.

Exceptions

get_waiter(waiter_name)

Returns an object that can wait for some condition.

Parameters
waiter_name (str) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
Returns
The specified waiter object.
Return type
botocore.waiter.Waiter
list_classification_jobs(**kwargs)

Retrieves a subset of information about one or more classification jobs.

See also: AWS API Documentation

Request Syntax

response = client.list_classification_jobs(
    filterCriteria={
        'excludes': [
            {
                'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                'key': 'jobType'|'jobStatus'|'createdAt'|'name',
                'values': [
                    'string',
                ]
            },
        ],
        'includes': [
            {
                'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                'key': 'jobType'|'jobStatus'|'createdAt'|'name',
                'values': [
                    'string',
                ]
            },
        ]
    },
    maxResults=123,
    nextToken='string',
    sortCriteria={
        'attributeName': 'createdAt'|'jobStatus'|'name'|'jobType',
        'orderBy': 'ASC'|'DESC'
    }
)
Parameters
  • filterCriteria (dict) --

    The criteria to use to filter the results.

    • excludes (list) --

      An array of objects, one for each condition that determines which jobs to exclude from the results.

      • (dict) --

        Specifies a condition that filters the results of a request for information about classification jobs. Each condition consists of a property, an operator, and one or more values.

        • comparator (string) --

          The operator to use to filter the results.

        • key (string) --

          The property to use to filter the results.

        • values (list) --

          An array that lists one or more values to use to filter the results.

          • (string) --
    • includes (list) --

      An array of objects, one for each condition that determines which jobs to include in the results.

      • (dict) --

        Specifies a condition that filters the results of a request for information about classification jobs. Each condition consists of a property, an operator, and one or more values.

        • comparator (string) --

          The operator to use to filter the results.

        • key (string) --

          The property to use to filter the results.

        • values (list) --

          An array that lists one or more values to use to filter the results.

          • (string) --
  • maxResults (integer) -- The maximum number of items to include in each page of the response.
  • nextToken (string) -- The nextToken string that specifies which page of results to return in a paginated response.
  • sortCriteria (dict) --

    The criteria to use to sort the results.

    • attributeName (string) --

      The property to sort the results by.

    • orderBy (string) --

      The sort order to apply to the results, based on the value for the property specified by the attributeName property. Valid values are: ASC, sort the results in ascending order; and, DESC, sort the results in descending order.

Return type

dict

Returns

Response Syntax

{
    'items': [
        {
            'bucketDefinitions': [
                {
                    'accountId': 'string',
                    'buckets': [
                        'string',
                    ]
                },
            ],
            'createdAt': datetime(2015, 1, 1),
            'jobId': 'string',
            'jobStatus': 'RUNNING'|'PAUSED'|'CANCELLED'|'COMPLETE'|'IDLE'|'USER_PAUSED',
            'jobType': 'ONE_TIME'|'SCHEDULED',
            'lastRunErrorStatus': {
                'code': 'NONE'|'ERROR'
            },
            'name': 'string',
            'userPausedDetails': {
                'jobExpiresAt': datetime(2015, 1, 1),
                'jobImminentExpirationHealthEventArn': 'string',
                'jobPausedAt': datetime(2015, 1, 1)
            },
            'bucketCriteria': {
                'excludes': {
                    'and': [
                        {
                            'simpleCriterion': {
                                'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                                'key': 'ACCOUNT_ID'|'S3_BUCKET_NAME'|'S3_BUCKET_EFFECTIVE_PERMISSION'|'S3_BUCKET_SHARED_ACCESS',
                                'values': [
                                    'string',
                                ]
                            },
                            'tagCriterion': {
                                'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                                'tagValues': [
                                    {
                                        'key': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
                'includes': {
                    'and': [
                        {
                            'simpleCriterion': {
                                'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                                'key': 'ACCOUNT_ID'|'S3_BUCKET_NAME'|'S3_BUCKET_EFFECTIVE_PERMISSION'|'S3_BUCKET_SHARED_ACCESS',
                                'values': [
                                    'string',
                                ]
                            },
                            'tagCriterion': {
                                'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                                'tagValues': [
                                    {
                                        'key': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                }
            }
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • items (list) --

      An array of objects, one for each job that meets the filter criteria specified in the request.

      • (dict) --

        Provides information about a classification job, including the current status of the job.

        • bucketDefinitions (list) --

          An array of objects, one for each Amazon Web Services account that owns specific S3 buckets for the job to analyze. Each object specifies the account ID for an account and one or more buckets to analyze for that account. A job's definition can contain a bucketDefinitions array or a bucketCriteria object, not both.

          • (dict) --

            Specifies an Amazon Web Services account that owns S3 buckets for a classification job to analyze, and one or more specific buckets to analyze for that account.

            • accountId (string) --

              The unique identifier for the Amazon Web Services account that owns the buckets.

            • buckets (list) --

              An array that lists the names of the buckets.

              • (string) --
        • createdAt (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when the job was created.

        • jobId (string) --

          The unique identifier for the job.

        • jobStatus (string) --

          The current status of the job. Possible values are:

          • CANCELLED - You cancelled the job or, if it's a one-time job, you paused the job and didn't resume it within 30 days.
          • COMPLETE - For a one-time job, Amazon Macie finished processing the data specified for the job. This value doesn't apply to recurring jobs.
          • IDLE - For a recurring job, the previous scheduled run is complete and the next scheduled run is pending. This value doesn't apply to one-time jobs.
          • PAUSED - Macie started running the job but additional processing would exceed the monthly sensitive data discovery quota for your account or one or more member accounts that the job analyzes data for.
          • RUNNING - For a one-time job, the job is in progress. For a recurring job, a scheduled run is in progress.
          • USER_PAUSED - You paused the job. If you paused the job while it had a status of RUNNING and you don't resume it within 30 days of pausing it, the job or job run will expire and be cancelled, depending on the job's type. To check the expiration date, refer to the UserPausedDetails.jobExpiresAt property.
        • jobType (string) --

          The schedule for running the job. Possible values are:

          • ONE_TIME - The job runs only once.
          • SCHEDULED - The job runs on a daily, weekly, or monthly basis.
        • lastRunErrorStatus (dict) --

          Specifies whether any account- or bucket-level access errors occurred when the job ran. For a recurring job, this value indicates the error status of the job's most recent run.

          • code (string) --

            Specifies whether any account- or bucket-level access errors occurred when the job ran. For a recurring job, this value indicates the error status of the job's most recent run. Possible values are:

            • ERROR - One or more errors occurred. Amazon Macie didn't process all the data specified for the job.
            • NONE - No errors occurred. Macie processed all the data specified for the job.
        • name (string) --

          The custom name of the job.

        • userPausedDetails (dict) --

          If the current status of the job is USER_PAUSED, specifies when the job was paused and when the job or job run will expire and be cancelled if it isn't resumed. This value is present only if the value for jobStatus is USER_PAUSED.

          • jobExpiresAt (datetime) --

            The date and time, in UTC and extended ISO 8601 format, when the job or job run will expire and be cancelled if you don't resume it first.

          • jobImminentExpirationHealthEventArn (string) --

            The Amazon Resource Name (ARN) of the Health event that Amazon Macie sent to notify you of the job or job run's pending expiration and cancellation. This value is null if a job has been paused for less than 23 days.

          • jobPausedAt (datetime) --

            The date and time, in UTC and extended ISO 8601 format, when you paused the job.

        • bucketCriteria (dict) --

          The property- and tag-based conditions that determine which S3 buckets are included or excluded from the job's analysis. Each time the job runs, the job uses these criteria to determine which buckets to analyze. A job's definition can contain a bucketCriteria object or a bucketDefinitions array, not both.

          • excludes (dict) --

            The property- and tag-based conditions that determine which buckets to exclude from the job.

            • and (list) --

              An array of conditions, one for each condition that determines which buckets to include or exclude from the job. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

              • (dict) --

                Specifies a property- or tag-based condition that defines criteria for including or excluding S3 buckets from a classification job.

                • simpleCriterion (dict) --

                  A property-based condition that defines a property, operator, and one or more values for including or excluding buckets from the job.

                  • comparator (string) --

                    The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

                  • key (string) --

                    The property to use in the condition.

                  • values (list) --

                    An array that lists one or more values to use in the condition. If you specify multiple values, Amazon Macie uses OR logic to join the values. Valid values for each supported property (key) are:

                    • ACCOUNT_ID - A string that represents the unique identifier for the Amazon Web Services account that owns the bucket.
                    • S3_BUCKET_EFFECTIVE_PERMISSION - A string that represents an enumerated value that Macie defines for the BucketPublicAccess.effectivePermission property of a bucket.
                    • S3_BUCKET_NAME - A string that represents the name of a bucket.
                    • S3_BUCKET_SHARED_ACCESS - A string that represents an enumerated value that Macie defines for the BucketMetadata.sharedAccess property of a bucket.

                    Values are case sensitive. Also, Macie doesn't support use of partial values or wildcard characters in these values.

                    • (string) --
                • tagCriterion (dict) --

                  A tag-based condition that defines an operator and tag keys, tag values, or tag key and value pairs for including or excluding buckets from the job.

                  • comparator (string) --

                    The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

                  • tagValues (list) --

                    The tag keys, tag values, or tag key and value pairs to use in the condition.

                    • (dict) --

                      Specifies a tag key, a tag value, or a tag key and value (as a pair) to use in a tag-based condition that determines whether an S3 bucket is included or excluded from a classification job. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based conditions.

                      • key (string) --

                        The value for the tag key to use in the condition.

                      • value (string) --

                        The tag value to use in the condition.

          • includes (dict) --

            The property- and tag-based conditions that determine which buckets to include in the job.

            • and (list) --

              An array of conditions, one for each condition that determines which buckets to include or exclude from the job. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

              • (dict) --

                Specifies a property- or tag-based condition that defines criteria for including or excluding S3 buckets from a classification job.

                • simpleCriterion (dict) --

                  A property-based condition that defines a property, operator, and one or more values for including or excluding buckets from the job.

                  • comparator (string) --

                    The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

                  • key (string) --

                    The property to use in the condition.

                  • values (list) --

                    An array that lists one or more values to use in the condition. If you specify multiple values, Amazon Macie uses OR logic to join the values. Valid values for each supported property (key) are:

                    • ACCOUNT_ID - A string that represents the unique identifier for the Amazon Web Services account that owns the bucket.
                    • S3_BUCKET_EFFECTIVE_PERMISSION - A string that represents an enumerated value that Macie defines for the BucketPublicAccess.effectivePermission property of a bucket.
                    • S3_BUCKET_NAME - A string that represents the name of a bucket.
                    • S3_BUCKET_SHARED_ACCESS - A string that represents an enumerated value that Macie defines for the BucketMetadata.sharedAccess property of a bucket.

                    Values are case sensitive. Also, Macie doesn't support use of partial values or wildcard characters in these values.

                    • (string) --
                • tagCriterion (dict) --

                  A tag-based condition that defines an operator and tag keys, tag values, or tag key and value pairs for including or excluding buckets from the job.

                  • comparator (string) --

                    The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

                  • tagValues (list) --

                    The tag keys, tag values, or tag key and value pairs to use in the condition.

                    • (dict) --

                      Specifies a tag key, a tag value, or a tag key and value (as a pair) to use in a tag-based condition that determines whether an S3 bucket is included or excluded from a classification job. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based conditions.

                      • key (string) --

                        The value for the tag key to use in the condition.

                      • value (string) --

                        The tag value to use in the condition.

    • nextToken (string) --

      The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.

Exceptions

list_custom_data_identifiers(**kwargs)

Retrieves a subset of information about all the custom data identifiers for an account.

See also: AWS API Documentation

Request Syntax

response = client.list_custom_data_identifiers(
    maxResults=123,
    nextToken='string'
)
Parameters
  • maxResults (integer) -- The maximum number of items to include in each page of the response.
  • nextToken (string) -- The nextToken string that specifies which page of results to return in a paginated response.
Return type

dict

Returns

Response Syntax

{
    'items': [
        {
            'arn': 'string',
            'createdAt': datetime(2015, 1, 1),
            'description': 'string',
            'id': 'string',
            'name': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • items (list) --

      An array of objects, one for each custom data identifier.

      • (dict) --

        Provides information about a custom data identifier.

        • arn (string) --

          The Amazon Resource Name (ARN) of the custom data identifier.

        • createdAt (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when the custom data identifier was created.

        • description (string) --

          The custom description of the custom data identifier.

        • id (string) --

          The unique identifier for the custom data identifier.

        • name (string) --

          The custom name of the custom data identifier.

    • nextToken (string) --

      The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.

Exceptions

list_findings(**kwargs)

Retrieves a subset of information about one or more findings.

See also: AWS API Documentation

Request Syntax

response = client.list_findings(
    findingCriteria={
        'criterion': {
            'string': {
                'eq': [
                    'string',
                ],
                'eqExactMatch': [
                    'string',
                ],
                'gt': 123,
                'gte': 123,
                'lt': 123,
                'lte': 123,
                'neq': [
                    'string',
                ]
            }
        }
    },
    maxResults=123,
    nextToken='string',
    sortCriteria={
        'attributeName': 'string',
        'orderBy': 'ASC'|'DESC'
    }
)
Parameters
  • findingCriteria (dict) --

    The criteria to use to filter the results.

    • criterion (dict) --

      A condition that specifies the property, operator, and one or more values to use to filter the results.

      • (string) --
        • (dict) --

          Specifies the operator to use in a property-based condition that filters the results of a query for findings. For detailed information and examples of each operator, see Fundamentals of filtering findings in the Amazon Macie User Guide .

          • eq (list) --

            The value for the property matches (equals) the specified value. If you specify multiple values, Macie uses OR logic to join the values.

            • (string) --
          • eqExactMatch (list) --

            The value for the property exclusively matches (equals an exact match for) all the specified values. If you specify multiple values, Amazon Macie uses AND logic to join the values.

            You can use this operator with the following properties: customDataIdentifiers.detections.arn, customDataIdentifiers.detections.name, resourcesAffected.s3Bucket.tags.key, resourcesAffected.s3Bucket.tags.value, resourcesAffected.s3Object.tags.key, resourcesAffected.s3Object.tags.value, sensitiveData.category, and sensitiveData.detections.type.

            • (string) --
          • gt (integer) --

            The value for the property is greater than the specified value.

          • gte (integer) --

            The value for the property is greater than or equal to the specified value.

          • lt (integer) --

            The value for the property is less than the specified value.

          • lte (integer) --

            The value for the property is less than or equal to the specified value.

          • neq (list) --

            The value for the property doesn't match (doesn't equal) the specified value. If you specify multiple values, Macie uses OR logic to join the values.

            • (string) --
  • maxResults (integer) -- The maximum number of items to include in each page of the response.
  • nextToken (string) -- The nextToken string that specifies which page of results to return in a paginated response.
  • sortCriteria (dict) --

    The criteria to use to sort the results.

    • attributeName (string) --

      The name of the property to sort the results by. This value can be the name of any property that Amazon Macie defines for a finding.

    • orderBy (string) --

      The sort order to apply to the results, based on the value for the property specified by the attributeName property. Valid values are: ASC, sort the results in ascending order; and, DESC, sort the results in descending order.

Return type

dict

Returns

Response Syntax

{
    'findingIds': [
        'string',
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • findingIds (list) --

      An array of strings, where each string is the unique identifier for a finding that meets the filter criteria specified in the request.

      • (string) --
    • nextToken (string) --

      The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.

Exceptions

list_findings_filters(**kwargs)

Retrieves a subset of information about all the findings filters for an account.

See also: AWS API Documentation

Request Syntax

response = client.list_findings_filters(
    maxResults=123,
    nextToken='string'
)
Parameters
  • maxResults (integer) -- The maximum number of items to include in each page of a paginated response.
  • nextToken (string) -- The nextToken string that specifies which page of results to return in a paginated response.
Return type

dict

Returns

Response Syntax

{
    'findingsFilterListItems': [
        {
            'action': 'ARCHIVE'|'NOOP',
            'arn': 'string',
            'id': 'string',
            'name': 'string',
            'tags': {
                'string': 'string'
            }
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • findingsFilterListItems (list) --

      An array of objects, one for each filter that's associated with the account.

      • (dict) --

        Provides information about a findings filter.

        • action (string) --

          The action that's performed on findings that meet the filter criteria. Possible values are: ARCHIVE, suppress (automatically archive) the findings; and, NOOP, don't perform any action on the findings.

        • arn (string) --

          The Amazon Resource Name (ARN) of the filter.

        • id (string) --

          The unique identifier for the filter.

        • name (string) --

          The custom name of the filter.

        • tags (dict) --

          A map of key-value pairs that identifies the tags (keys and values) that are associated with the filter.

          • (string) --
            • (string) --
    • nextToken (string) --

      The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.

Exceptions

list_invitations(**kwargs)

Retrieves information about the Amazon Macie membership invitations that were received by an account.

See also: AWS API Documentation

Request Syntax

response = client.list_invitations(
    maxResults=123,
    nextToken='string'
)
Parameters
  • maxResults (integer) -- The maximum number of items to include in each page of a paginated response.
  • nextToken (string) -- The nextToken string that specifies which page of results to return in a paginated response.
Return type

dict

Returns

Response Syntax

{
    'invitations': [
        {
            'accountId': 'string',
            'invitationId': 'string',
            'invitedAt': datetime(2015, 1, 1),
            'relationshipStatus': 'Enabled'|'Paused'|'Invited'|'Created'|'Removed'|'Resigned'|'EmailVerificationInProgress'|'EmailVerificationFailed'|'RegionDisabled'|'AccountSuspended'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • invitations (list) --

      An array of objects, one for each invitation that was received by the account.

      • (dict) --

        Provides information about an Amazon Macie membership invitation that was received by an account.

        • accountId (string) --

          The Amazon Web Services account ID for the account that sent the invitation.

        • invitationId (string) --

          The unique identifier for the invitation. Amazon Macie uses this identifier to validate the inviter account with the invitee account.

        • invitedAt (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when the invitation was sent.

        • relationshipStatus (string) --

          The status of the relationship between the account that sent the invitation (inviter account ) and the account that received the invitation (invitee account ).

    • nextToken (string) --

      The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.

Exceptions

list_managed_data_identifiers(**kwargs)

Retrieves information about all the managed data identifiers that Amazon Macie currently provides.

See also: AWS API Documentation

Request Syntax

response = client.list_managed_data_identifiers(
    nextToken='string'
)
Parameters
nextToken (string) -- The nextToken string that specifies which page of results to return in a paginated response.
Return type
dict
Returns
Response Syntax
{
    'items': [
        {
            'category': 'FINANCIAL_INFORMATION'|'PERSONAL_INFORMATION'|'CREDENTIALS'|'CUSTOM_IDENTIFIER',
            'id': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • items (list) --

      An array of objects, one for each managed data identifier.

      • (dict) --

        Provides information about a managed data identifier. For additional information, see Using managed data identifiers in the Amazon Macie User Guide .

        • category (string) --

          The category of sensitive data that the managed data identifier detects: CREDENTIALS, for credentials data such as private keys or Amazon Web Services secret keys; FINANCIAL_INFORMATION, for financial data such as credit card numbers; or, PERSONAL_INFORMATION, for personal health information, such as health insurance identification numbers, or personally identifiable information, such as passport numbers.

        • id (string) --

          The unique identifier for the managed data identifier. This is a string that describes the type of sensitive data that the managed data identifier detects. For example: OPENSSH_PRIVATE_KEY for OpenSSH private keys, CREDIT_CARD_NUMBER for credit card numbers, or USA_PASSPORT_NUMBER for US passport numbers.

    • nextToken (string) --

      The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.

list_members(**kwargs)

Retrieves information about the accounts that are associated with an Amazon Macie administrator account.

See also: AWS API Documentation

Request Syntax

response = client.list_members(
    maxResults=123,
    nextToken='string',
    onlyAssociated='string'
)
Parameters
  • maxResults (integer) -- The maximum number of items to include in each page of a paginated response.
  • nextToken (string) -- The nextToken string that specifies which page of results to return in a paginated response.
  • onlyAssociated (string) -- Specifies which accounts to include in the response, based on the status of an account's relationship with the administrator account. By default, the response includes only current member accounts. To include all accounts, set this value to false.
Return type

dict

Returns

Response Syntax

{
    'members': [
        {
            'accountId': 'string',
            'administratorAccountId': 'string',
            'arn': 'string',
            'email': 'string',
            'invitedAt': datetime(2015, 1, 1),
            'masterAccountId': 'string',
            'relationshipStatus': 'Enabled'|'Paused'|'Invited'|'Created'|'Removed'|'Resigned'|'EmailVerificationInProgress'|'EmailVerificationFailed'|'RegionDisabled'|'AccountSuspended',
            'tags': {
                'string': 'string'
            },
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • members (list) --

      An array of objects, one for each account that's associated with the administrator account and meets the criteria specified by the onlyAssociated request parameter.

      • (dict) --

        Provides information about an account that's associated with an Amazon Macie administrator account.

        • accountId (string) --

          The Amazon Web Services account ID for the account.

        • administratorAccountId (string) --

          The Amazon Web Services account ID for the administrator account.

        • arn (string) --

          The Amazon Resource Name (ARN) of the account.

        • email (string) --

          The email address for the account.

        • invitedAt (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when an Amazon Macie membership invitation was last sent to the account. This value is null if a Macie invitation hasn't been sent to the account.

        • masterAccountId (string) --

          (Deprecated) The Amazon Web Services account ID for the administrator account. This property has been replaced by the administratorAccountId property and is retained only for backward compatibility.

        • relationshipStatus (string) --

          The current status of the relationship between the account and the administrator account.

        • tags (dict) --

          A map of key-value pairs that identifies the tags (keys and values) that are associated with the account in Amazon Macie.

          • (string) --
            • (string) --
        • updatedAt (datetime) --

          The date and time, in UTC and extended ISO 8601 format, of the most recent change to the status of the relationship between the account and the administrator account.

    • nextToken (string) --

      The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.

Exceptions

list_organization_admin_accounts(**kwargs)

Retrieves information about the delegated Amazon Macie administrator account for an Amazon Web Services organization.

See also: AWS API Documentation

Request Syntax

response = client.list_organization_admin_accounts(
    maxResults=123,
    nextToken='string'
)
Parameters
  • maxResults (integer) -- The maximum number of items to include in each page of a paginated response.
  • nextToken (string) -- The nextToken string that specifies which page of results to return in a paginated response.
Return type

dict

Returns

Response Syntax

{
    'adminAccounts': [
        {
            'accountId': 'string',
            'status': 'ENABLED'|'DISABLING_IN_PROGRESS'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • adminAccounts (list) --

      An array of objects, one for each delegated Amazon Macie administrator account for the organization. Only one of these accounts can have a status of ENABLED.

      • (dict) --

        Provides information about the delegated Amazon Macie administrator account for an Amazon Web Services organization.

        • accountId (string) --

          The Amazon Web Services account ID for the account.

        • status (string) --

          The current status of the account as the delegated administrator of Amazon Macie for the organization.

    • nextToken (string) --

      The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.

Exceptions

list_tags_for_resource(**kwargs)

Retrieves the tags (keys and values) that are associated with a classification job, custom data identifier, findings filter, or member account.

See also: AWS API Documentation

Request Syntax

response = client.list_tags_for_resource(
    resourceArn='string'
)
Parameters
resourceArn (string) --

[REQUIRED]

The Amazon Resource Name (ARN) of the classification job, custom data identifier, findings filter, or member account.

Return type
dict
Returns
Response Syntax
{
    'tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    The request succeeded.

    • tags (dict) --

      A map of key-value pairs that identifies the tags (keys and values) that are associated with the resource.

      • (string) --
        • (string) --
put_classification_export_configuration(**kwargs)

Creates or updates the configuration settings for storing data classification results.

See also: AWS API Documentation

Request Syntax

response = client.put_classification_export_configuration(
    configuration={
        's3Destination': {
            'bucketName': 'string',
            'keyPrefix': 'string',
            'kmsKeyArn': 'string'
        }
    }
)
Parameters
configuration (dict) --

[REQUIRED]

The location to store data classification results in, and the encryption settings to use when storing results in that location.

  • s3Destination (dict) --

    The S3 bucket to store data classification results in, and the encryption settings to use when storing results in that bucket.

    • bucketName (string) -- [REQUIRED]

      The name of the bucket.

    • keyPrefix (string) --

      The path prefix to use in the path to the location in the bucket. This prefix specifies where to store classification results in the bucket.

    • kmsKeyArn (string) -- [REQUIRED]

      The Amazon Resource Name (ARN) of the KMS key to use for encryption of the results. This must be the ARN of an existing, symmetric, customer managed KMS key that's in the same Amazon Web Services Region as the bucket.

Return type
dict
Returns
Response Syntax
{
    'configuration': {
        's3Destination': {
            'bucketName': 'string',
            'keyPrefix': 'string',
            'kmsKeyArn': 'string'
        }
    }
}

Response Structure

  • (dict) --

    The request succeeded.

    • configuration (dict) --

      The location where the data classification results are stored, and the encryption settings that are used when storing results in that location.

      • s3Destination (dict) --

        The S3 bucket to store data classification results in, and the encryption settings to use when storing results in that bucket.

        • bucketName (string) --

          The name of the bucket.

        • keyPrefix (string) --

          The path prefix to use in the path to the location in the bucket. This prefix specifies where to store classification results in the bucket.

        • kmsKeyArn (string) --

          The Amazon Resource Name (ARN) of the KMS key to use for encryption of the results. This must be the ARN of an existing, symmetric, customer managed KMS key that's in the same Amazon Web Services Region as the bucket.

Exceptions

put_findings_publication_configuration(**kwargs)

Updates the configuration settings for publishing findings to Security Hub.

See also: AWS API Documentation

Request Syntax

response = client.put_findings_publication_configuration(
    clientToken='string',
    securityHubConfiguration={
        'publishClassificationFindings': True|False,
        'publishPolicyFindings': True|False
    }
)
Parameters
  • clientToken (string) --

    A unique, case-sensitive token that you provide to ensure the idempotency of the request.

    This field is autopopulated if not provided.

  • securityHubConfiguration (dict) --

    The configuration settings that determine which findings to publish to Security Hub.

    • publishClassificationFindings (boolean) -- [REQUIRED]

      Specifies whether to publish sensitive data findings to Security Hub. If you set this value to true, Amazon Macie automatically publishes all sensitive data findings that weren't suppressed by a findings filter. The default value is false.

    • publishPolicyFindings (boolean) -- [REQUIRED]

      Specifies whether to publish policy findings to Security Hub. If you set this value to true, Amazon Macie automatically publishes all new and updated policy findings that weren't suppressed by a findings filter. The default value is true.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

    The request succeeded and there isn't any content to include in the body of the response (No Content).

Exceptions

search_resources(**kwargs)

Retrieves (queries) statistical data and other information about Amazon Web Services resources that Amazon Macie monitors and analyzes.

See also: AWS API Documentation

Request Syntax

response = client.search_resources(
    bucketCriteria={
        'excludes': {
            'and': [
                {
                    'simpleCriterion': {
                        'comparator': 'EQ'|'NE',
                        'key': 'ACCOUNT_ID'|'S3_BUCKET_NAME'|'S3_BUCKET_EFFECTIVE_PERMISSION'|'S3_BUCKET_SHARED_ACCESS',
                        'values': [
                            'string',
                        ]
                    },
                    'tagCriterion': {
                        'comparator': 'EQ'|'NE',
                        'tagValues': [
                            {
                                'key': 'string',
                                'value': 'string'
                            },
                        ]
                    }
                },
            ]
        },
        'includes': {
            'and': [
                {
                    'simpleCriterion': {
                        'comparator': 'EQ'|'NE',
                        'key': 'ACCOUNT_ID'|'S3_BUCKET_NAME'|'S3_BUCKET_EFFECTIVE_PERMISSION'|'S3_BUCKET_SHARED_ACCESS',
                        'values': [
                            'string',
                        ]
                    },
                    'tagCriterion': {
                        'comparator': 'EQ'|'NE',
                        'tagValues': [
                            {
                                'key': 'string',
                                'value': 'string'
                            },
                        ]
                    }
                },
            ]
        }
    },
    maxResults=123,
    nextToken='string',
    sortCriteria={
        'attributeName': 'ACCOUNT_ID'|'RESOURCE_NAME'|'S3_CLASSIFIABLE_OBJECT_COUNT'|'S3_CLASSIFIABLE_SIZE_IN_BYTES',
        'orderBy': 'ASC'|'DESC'
    }
)
Parameters
  • bucketCriteria (dict) --

    The filter conditions that determine which S3 buckets to include or exclude from the query results.

    • excludes (dict) --

      The property- and tag-based conditions that determine which buckets to exclude from the results.

      • and (list) --

        An array of objects, one for each property- or tag-based condition that includes or excludes resources from the query results. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

        • (dict) --

          Specifies a property- or tag-based filter condition for including or excluding Amazon Web Services resources from the query results.

          • simpleCriterion (dict) --

            A property-based condition that defines a property, operator, and one or more values for including or excluding resources from the results.

            • comparator (string) --

              The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

            • key (string) --

              The property to use in the condition.

            • values (list) --

              An array that lists one or more values to use in the condition. If you specify multiple values, Amazon Macie uses OR logic to join the values. Valid values for each supported property (key) are:

              • ACCOUNT_ID - A string that represents the unique identifier for the Amazon Web Services account that owns the resource.
              • S3_BUCKET_EFFECTIVE_PERMISSION - A string that represents an enumerated value that Macie defines for the BucketPublicAccess.effectivePermission property of an S3 bucket.
              • S3_BUCKET_NAME - A string that represents the name of an S3 bucket.
              • S3_BUCKET_SHARED_ACCESS - A string that represents an enumerated value that Macie defines for the BucketMetadata.sharedAccess property of an S3 bucket.

              Values are case sensitive. Also, Macie doesn't support use of partial values or wildcard characters in values.

              • (string) --
          • tagCriterion (dict) --

            A tag-based condition that defines an operator and tag keys, tag values, or tag key and value pairs for including or excluding resources from the results.

            • comparator (string) --

              The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

            • tagValues (list) --

              The tag keys, tag values, or tag key and value pairs to use in the condition.

              • (dict) --

                Specifies a tag key, a tag value, or a tag key and value (as a pair) to use in a tag-based filter condition for a query. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based filter conditions.

                • key (string) --

                  The value for the tag key to use in the condition.

                • value (string) --

                  The tag value to use in the condition.

    • includes (dict) --

      The property- and tag-based conditions that determine which buckets to include in the results.

      • and (list) --

        An array of objects, one for each property- or tag-based condition that includes or excludes resources from the query results. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

        • (dict) --

          Specifies a property- or tag-based filter condition for including or excluding Amazon Web Services resources from the query results.

          • simpleCriterion (dict) --

            A property-based condition that defines a property, operator, and one or more values for including or excluding resources from the results.

            • comparator (string) --

              The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

            • key (string) --

              The property to use in the condition.

            • values (list) --

              An array that lists one or more values to use in the condition. If you specify multiple values, Amazon Macie uses OR logic to join the values. Valid values for each supported property (key) are:

              • ACCOUNT_ID - A string that represents the unique identifier for the Amazon Web Services account that owns the resource.
              • S3_BUCKET_EFFECTIVE_PERMISSION - A string that represents an enumerated value that Macie defines for the BucketPublicAccess.effectivePermission property of an S3 bucket.
              • S3_BUCKET_NAME - A string that represents the name of an S3 bucket.
              • S3_BUCKET_SHARED_ACCESS - A string that represents an enumerated value that Macie defines for the BucketMetadata.sharedAccess property of an S3 bucket.

              Values are case sensitive. Also, Macie doesn't support use of partial values or wildcard characters in values.

              • (string) --
          • tagCriterion (dict) --

            A tag-based condition that defines an operator and tag keys, tag values, or tag key and value pairs for including or excluding resources from the results.

            • comparator (string) --

              The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

            • tagValues (list) --

              The tag keys, tag values, or tag key and value pairs to use in the condition.

              • (dict) --

                Specifies a tag key, a tag value, or a tag key and value (as a pair) to use in a tag-based filter condition for a query. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based filter conditions.

                • key (string) --

                  The value for the tag key to use in the condition.

                • value (string) --

                  The tag value to use in the condition.

  • maxResults (integer) -- The maximum number of items to include in each page of the response. The default value is 50.
  • nextToken (string) -- The nextToken string that specifies which page of results to return in a paginated response.
  • sortCriteria (dict) --

    The criteria to use to sort the results.

    • attributeName (string) --

      The property to sort the results by.

    • orderBy (string) --

      The sort order to apply to the results, based on the value for the property specified by the attributeName property. Valid values are: ASC, sort the results in ascending order; and, DESC, sort the results in descending order.

Return type

dict

Returns

Response Syntax

{
    'matchingResources': [
        {
            'matchingBucket': {
                'accountId': 'string',
                'bucketName': 'string',
                'classifiableObjectCount': 123,
                'classifiableSizeInBytes': 123,
                'errorCode': 'ACCESS_DENIED',
                'errorMessage': 'string',
                'jobDetails': {
                    'isDefinedInJob': 'TRUE'|'FALSE'|'UNKNOWN',
                    'isMonitoredByJob': 'TRUE'|'FALSE'|'UNKNOWN',
                    'lastJobId': 'string',
                    'lastJobRunTime': datetime(2015, 1, 1)
                },
                'objectCount': 123,
                'objectCountByEncryptionType': {
                    'customerManaged': 123,
                    'kmsManaged': 123,
                    's3Managed': 123,
                    'unencrypted': 123,
                    'unknown': 123
                },
                'sizeInBytes': 123,
                'sizeInBytesCompressed': 123,
                'unclassifiableObjectCount': {
                    'fileType': 123,
                    'storageClass': 123,
                    'total': 123
                },
                'unclassifiableObjectSizeInBytes': {
                    'fileType': 123,
                    'storageClass': 123,
                    'total': 123
                }
            }
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • matchingResources (list) --

      An array of objects, one for each resource that meets the filter criteria specified in the request.

      • (dict) --

        Provides statistical data and other information about an Amazon Web Services resource that Amazon Macie monitors and analyzes for your account.

        • matchingBucket (dict) --

          The details of an S3 bucket that Amazon Macie monitors and analyzes.

          • accountId (string) --

            The unique identifier for the Amazon Web Services account that owns the bucket.

          • bucketName (string) --

            The name of the bucket.

          • classifiableObjectCount (integer) --

            The total number of objects that Amazon Macie can analyze in the bucket. These objects use a supported storage class and have a file name extension for a supported file or storage format.

          • classifiableSizeInBytes (integer) --

            The total storage size, in bytes, of the objects that Amazon Macie can analyze in the bucket. These objects use a supported storage class and have a file name extension for a supported file or storage format.

            If versioning is enabled for the bucket, Macie calculates this value based on the size of the latest version of each applicable object in the bucket. This value doesn't reflect the storage size of all versions of each applicable object in the bucket.

          • errorCode (string) --

            Specifies the error code for an error that prevented Amazon Macie from retrieving and processing information about the bucket and the bucket's objects. If this value is ACCESS_DENIED, Macie doesn't have permission to retrieve the information. For example, the bucket has a restrictive bucket policy and Amazon S3 denied the request. If this value is null, Macie was able to retrieve and process the information.

          • errorMessage (string) --

            A brief description of the error (errorCode) that prevented Amazon Macie from retrieving and processing information about the bucket and the bucket's objects. This value is null if Macie was able to retrieve and process the information.

          • jobDetails (dict) --

            Specifies whether any one-time or recurring classification jobs are configured to analyze objects in the bucket, and, if so, the details of the job that ran most recently.

            • isDefinedInJob (string) --

              Specifies whether any one-time or recurring jobs are configured to analyze data in the bucket. Possible values are:

              • TRUE - The bucket is explicitly included in the bucket definition (S3BucketDefinitionForJob) for one or more jobs and at least one of those jobs has a status other than CANCELLED. Or the bucket matched the bucket criteria (S3BucketCriteriaForJob) for at least one job that previously ran.
              • FALSE - The bucket isn't explicitly included in the bucket definition (S3BucketDefinitionForJob) for any jobs, all the jobs that explicitly include the bucket in their bucket definitions have a status of CANCELLED, or the bucket didn't match the bucket criteria (S3BucketCriteriaForJob) for any jobs that previously ran.
              • UNKNOWN - An exception occurred when Amazon Macie attempted to retrieve job data for the bucket.
            • isMonitoredByJob (string) --

              Specifies whether any recurring jobs are configured to analyze data in the bucket. Possible values are:

              • TRUE - The bucket is explicitly included in the bucket definition (S3BucketDefinitionForJob) for one or more recurring jobs or the bucket matches the bucket criteria (S3BucketCriteriaForJob) for one or more recurring jobs. At least one of those jobs has a status other than CANCELLED.
              • FALSE - The bucket isn't explicitly included in the bucket definition (S3BucketDefinitionForJob) for any recurring jobs, the bucket doesn't match the bucket criteria (S3BucketCriteriaForJob) for any recurring jobs, or all the recurring jobs that are configured to analyze data in the bucket have a status of CANCELLED.
              • UNKNOWN - An exception occurred when Amazon Macie attempted to retrieve job data for the bucket.
            • lastJobId (string) --

              The unique identifier for the job that ran most recently and is configured to analyze data in the bucket, either the latest run of a recurring job or the only run of a one-time job.

              This value is typically null if the value for the isDefinedInJob property is FALSE or UNKNOWN.

            • lastJobRunTime (datetime) --

              The date and time, in UTC and extended ISO 8601 format, when the job (lastJobId) started. If the job is a recurring job, this value indicates when the most recent run started.

              This value is typically null if the value for the isDefinedInJob property is FALSE or UNKNOWN.

          • objectCount (integer) --

            The total number of objects in the bucket.

          • objectCountByEncryptionType (dict) --

            The total number of objects that are in the bucket, grouped by server-side encryption type. This includes a grouping that reports the total number of objects that aren't encrypted or use client-side encryption.

            • customerManaged (integer) --

              The total number of objects that are encrypted with a customer-provided key. The objects use customer-provided server-side encryption (SSE-C).

            • kmsManaged (integer) --

              The total number of objects that are encrypted with an KMS key, either an Amazon Web Services managed key or a customer managed key. The objects use KMS encryption (SSE-KMS).

            • s3Managed (integer) --

              The total number of objects that are encrypted with an Amazon S3 managed key. The objects use Amazon S3 managed encryption (SSE-S3).

            • unencrypted (integer) --

              The total number of objects that aren't encrypted or use client-side encryption.

            • unknown (integer) --

              The total number of objects that Amazon Macie doesn't have current encryption metadata for. Macie can't provide current data about the encryption settings for these objects.

          • sizeInBytes (integer) --

            The total storage size, in bytes, of the bucket.

            If versioning is enabled for the bucket, Amazon Macie calculates this value based on the size of the latest version of each object in the bucket. This value doesn't reflect the storage size of all versions of each object in the bucket.

          • sizeInBytesCompressed (integer) --

            The total storage size, in bytes, of the objects that are compressed (.gz, .gzip, .zip) files in the bucket.

            If versioning is enabled for the bucket, Amazon Macie calculates this value based on the size of the latest version of each applicable object in the bucket. This value doesn't reflect the storage size of all versions of each applicable object in the bucket.

          • unclassifiableObjectCount (dict) --

            The total number of objects that Amazon Macie can't analyze in the bucket. These objects don't use a supported storage class or don't have a file name extension for a supported file or storage format.

            • fileType (integer) --

              The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects don't have a file name extension for a supported file or storage format.

            • storageClass (integer) --

              The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class.

            • total (integer) --

              The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class or don't have a file name extension for a supported file or storage format.

          • unclassifiableObjectSizeInBytes (dict) --

            The total storage size, in bytes, of the objects that Amazon Macie can't analyze in the bucket. These objects don't use a supported storage class or don't have a file name extension for a supported file or storage format.

            • fileType (integer) --

              The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects don't have a file name extension for a supported file or storage format.

            • storageClass (integer) --

              The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class.

            • total (integer) --

              The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class or don't have a file name extension for a supported file or storage format.

    • nextToken (string) --

      The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.

Exceptions

tag_resource(**kwargs)

Adds or updates one or more tags (keys and values) that are associated with a classification job, custom data identifier, findings filter, or member account.

See also: AWS API Documentation

Request Syntax

response = client.tag_resource(
    resourceArn='string',
    tags={
        'string': 'string'
    }
)
Parameters
  • resourceArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of the classification job, custom data identifier, findings filter, or member account.

  • tags (dict) --

    [REQUIRED]

    A map of key-value pairs that specifies the tags to associate with the resource.

    A resource can have a maximum of 50 tags. Each tag consists of a tag key and an associated tag value. The maximum length of a tag key is 128 characters. The maximum length of a tag value is 256 characters.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

    The request succeeded and there isn't any content to include in the body of the response (No Content).

test_custom_data_identifier(**kwargs)

Tests a custom data identifier.

See also: AWS API Documentation

Request Syntax

response = client.test_custom_data_identifier(
    ignoreWords=[
        'string',
    ],
    keywords=[
        'string',
    ],
    maximumMatchDistance=123,
    regex='string',
    sampleText='string'
)
Parameters
  • ignoreWords (list) --

    An array that lists specific character sequences (ignore words) to exclude from the results. If the text matched by the regular expression is the same as any string in this array, Amazon Macie ignores it. The array can contain as many as 10 ignore words. Each ignore word can contain 4-90 UTF-8 characters. Ignore words are case sensitive.

    • (string) --
  • keywords (list) --

    An array that lists specific character sequences (keywords), one of which must be within proximity (maximumMatchDistance) of the regular expression to match. The array can contain as many as 50 keywords. Each keyword can contain 3-90 UTF-8 characters. Keywords aren't case sensitive.

    • (string) --
  • maximumMatchDistance (integer) -- The maximum number of characters that can exist between text that matches the regex pattern and the character sequences specified by the keywords array. Amazon Macie includes or excludes a result based on the proximity of a keyword to text that matches the regex pattern. The distance can be 1-300 characters. The default value is 50.
  • regex (string) --

    [REQUIRED]

    The regular expression (regex ) that defines the pattern to match. The expression can contain as many as 512 characters.

  • sampleText (string) --

    [REQUIRED]

    The sample text to inspect by using the custom data identifier. The text can contain as many as 1,000 characters.

Return type

dict

Returns

Response Syntax

{
    'matchCount': 123
}

Response Structure

  • (dict) --

    The request succeeded.

    • matchCount (integer) --

      The number of instances of sample text that matched the detection criteria specified in the custom data identifier.

Exceptions

untag_resource(**kwargs)

Removes one or more tags (keys and values) from a classification job, custom data identifier, findings filter, or member account.

See also: AWS API Documentation

Request Syntax

response = client.untag_resource(
    resourceArn='string',
    tagKeys=[
        'string',
    ]
)
Parameters
  • resourceArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of the classification job, custom data identifier, findings filter, or member account.

  • tagKeys (list) --

    [REQUIRED]

    The key of the tag to remove from the resource. To remove multiple tags, append the tagKeys parameter and argument for each additional tag to remove, separated by an ampersand (&).

    • (string) --
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

    The request succeeded and there isn't any content to include in the body of the response (No Content).

update_classification_job(**kwargs)

Changes the status of a classification job.

See also: AWS API Documentation

Request Syntax

response = client.update_classification_job(
    jobId='string',
    jobStatus='RUNNING'|'PAUSED'|'CANCELLED'|'COMPLETE'|'IDLE'|'USER_PAUSED'
)
Parameters
  • jobId (string) --

    [REQUIRED]

    The unique identifier for the classification job.

  • jobStatus (string) --

    [REQUIRED]

    The new status for the job. Valid values are:

    • CANCELLED - Stops the job permanently and cancels it. This value is valid only if the job's current status is IDLE, PAUSED, RUNNING, or USER_PAUSED. If you specify this value and the job's current status is RUNNING, Amazon Macie immediately begins to stop all processing tasks for the job. You can't resume or restart a job after you cancel it.
    • RUNNING - Resumes the job. This value is valid only if the job's current status is USER_PAUSED. If you paused the job while it was actively running and you specify this value less than 30 days after you paused the job, Macie immediately resumes processing from the point where you paused the job. Otherwise, Macie resumes the job according to the schedule and other settings for the job.
    • USER_PAUSED - Pauses the job temporarily. This value is valid only if the job's current status is IDLE, PAUSED, or RUNNING. If you specify this value and the job's current status is RUNNING, Macie immediately begins to pause all processing tasks for the job. If you pause a one-time job and you don't resume it within 30 days, the job expires and Macie cancels the job. If you pause a recurring job when its status is RUNNING and you don't resume it within 30 days, the job run expires and Macie cancels the run. To check the expiration date, refer to the UserPausedDetails.jobExpiresAt property.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

    The request succeeded. The job's status was changed and there isn't any content to include in the body of the response (No Content).

Exceptions

update_findings_filter(**kwargs)

Updates the criteria and other settings for a findings filter.

See also: AWS API Documentation

Request Syntax

response = client.update_findings_filter(
    action='ARCHIVE'|'NOOP',
    description='string',
    findingCriteria={
        'criterion': {
            'string': {
                'eq': [
                    'string',
                ],
                'eqExactMatch': [
                    'string',
                ],
                'gt': 123,
                'gte': 123,
                'lt': 123,
                'lte': 123,
                'neq': [
                    'string',
                ]
            }
        }
    },
    id='string',
    name='string',
    position=123,
    clientToken='string'
)
Parameters
  • action (string) -- The action to perform on findings that meet the filter criteria (findingCriteria). Valid values are: ARCHIVE, suppress (automatically archive) the findings; and, NOOP, don't perform any action on the findings.
  • description (string) --

    A custom description of the filter. The description can contain as many as 512 characters.

    We strongly recommend that you avoid including any sensitive data in the description of a filter. Other users might be able to see the filter's description, depending on the actions that they're allowed to perform in Amazon Macie.

  • findingCriteria (dict) --

    The criteria to use to filter findings.

    • criterion (dict) --

      A condition that specifies the property, operator, and one or more values to use to filter the results.

      • (string) --
        • (dict) --

          Specifies the operator to use in a property-based condition that filters the results of a query for findings. For detailed information and examples of each operator, see Fundamentals of filtering findings in the Amazon Macie User Guide .

          • eq (list) --

            The value for the property matches (equals) the specified value. If you specify multiple values, Macie uses OR logic to join the values.

            • (string) --
          • eqExactMatch (list) --

            The value for the property exclusively matches (equals an exact match for) all the specified values. If you specify multiple values, Amazon Macie uses AND logic to join the values.

            You can use this operator with the following properties: customDataIdentifiers.detections.arn, customDataIdentifiers.detections.name, resourcesAffected.s3Bucket.tags.key, resourcesAffected.s3Bucket.tags.value, resourcesAffected.s3Object.tags.key, resourcesAffected.s3Object.tags.value, sensitiveData.category, and sensitiveData.detections.type.

            • (string) --
          • gt (integer) --

            The value for the property is greater than the specified value.

          • gte (integer) --

            The value for the property is greater than or equal to the specified value.

          • lt (integer) --

            The value for the property is less than the specified value.

          • lte (integer) --

            The value for the property is less than or equal to the specified value.

          • neq (list) --

            The value for the property doesn't match (doesn't equal) the specified value. If you specify multiple values, Macie uses OR logic to join the values.

            • (string) --
  • id (string) --

    [REQUIRED]

    The unique identifier for the Amazon Macie resource or account that the request applies to.

  • name (string) --

    A custom name for the filter. The name must contain at least 3 characters and can contain as many as 64 characters.

    We strongly recommend that you avoid including any sensitive data in the name of a filter. Other users might be able to see the filter's name, depending on the actions that they're allowed to perform in Amazon Macie.

  • position (integer) -- The position of the filter in the list of saved filters on the Amazon Macie console. This value also determines the order in which the filter is applied to findings, relative to other filters that are also applied to the findings.
  • clientToken (string) --

    A unique, case-sensitive token that you provide to ensure the idempotency of the request.

    This field is autopopulated if not provided.

Return type

dict

Returns

Response Syntax

{
    'arn': 'string',
    'id': 'string'
}

Response Structure

  • (dict) --

    The request succeeded. The specified findings filter was updated.

    • arn (string) --

      The Amazon Resource Name (ARN) of the filter that was updated.

    • id (string) --

      The unique identifier for the filter that was updated.

Exceptions

update_macie_session(**kwargs)

Suspends or re-enables an Amazon Macie account, or updates the configuration settings for a Macie account.

See also: AWS API Documentation

Request Syntax

response = client.update_macie_session(
    findingPublishingFrequency='FIFTEEN_MINUTES'|'ONE_HOUR'|'SIX_HOURS',
    status='PAUSED'|'ENABLED'
)
Parameters
  • findingPublishingFrequency (string) -- Specifies how often to publish updates to policy findings for the account. This includes publishing updates to Security Hub and Amazon EventBridge (formerly called Amazon CloudWatch Events).
  • status (string) -- Specifies a new status for the account. Valid values are: ENABLED, resume all Amazon Macie activities for the account; and, PAUSED, suspend all Macie activities for the account.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

    The request succeeded and there isn't any content to include in the body of the response (No Content).

Exceptions

update_member_session(**kwargs)

Enables an Amazon Macie administrator to suspend or re-enable a member account.

See also: AWS API Documentation

Request Syntax

response = client.update_member_session(
    id='string',
    status='PAUSED'|'ENABLED'
)
Parameters
  • id (string) --

    [REQUIRED]

    The unique identifier for the Amazon Macie resource or account that the request applies to.

  • status (string) --

    [REQUIRED]

    Specifies the new status for the account. Valid values are: ENABLED, resume all Amazon Macie activities for the account; and, PAUSED, suspend all Macie activities for the account.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

    The request succeeded and there isn't any content to include in the body of the response (No Content).

Exceptions

update_organization_configuration(**kwargs)

Updates the Amazon Macie configuration settings for an Amazon Web Services organization.

See also: AWS API Documentation

Request Syntax

response = client.update_organization_configuration(
    autoEnable=True|False
)
Parameters
autoEnable (boolean) --

[REQUIRED]

Specifies whether to enable Amazon Macie automatically for each account, when the account is added to the Amazon Web Services organization.

Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --

    The request succeeded and there isn't any content to include in the body of the response (No Content).

Exceptions

Client Exceptions

Client exceptions are available on a client instance via the exceptions property. For more detailed instructions and examples on the exact usage of client exceptions, see the error handling user guide.

The available client exceptions are:

class Macie2.Client.exceptions.AccessDeniedException

Provides information about an error that occurred due to insufficient access to a specified resource.

Example

try:
  ...
except client.exceptions.AccessDeniedException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    Provides information about an error that occurred due to insufficient access to a specified resource.

    • message (string) --

      The explanation of the error that occurred.

    • Error (dict) -- Normalized access to common exception attributes.

      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Macie2.Client.exceptions.ConflictException

Provides information about an error that occurred due to a versioning conflict for a specified resource.

Example

try:
  ...
except client.exceptions.ConflictException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    Provides information about an error that occurred due to a versioning conflict for a specified resource.

    • message (string) --

      The explanation of the error that occurred.

    • Error (dict) -- Normalized access to common exception attributes.

      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Macie2.Client.exceptions.InternalServerException

Provides information about an error that occurred due to an unknown internal server error, exception, or failure.

Example

try:
  ...
except client.exceptions.InternalServerException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    Provides information about an error that occurred due to an unknown internal server error, exception, or failure.

    • message (string) --

      The explanation of the error that occurred.

    • Error (dict) -- Normalized access to common exception attributes.

      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Macie2.Client.exceptions.ResourceNotFoundException

Provides information about an error that occurred because a specified resource wasn't found.

Example

try:
  ...
except client.exceptions.ResourceNotFoundException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    Provides information about an error that occurred because a specified resource wasn't found.

    • message (string) --

      The explanation of the error that occurred.

    • Error (dict) -- Normalized access to common exception attributes.

      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Macie2.Client.exceptions.ServiceQuotaExceededException

Provides information about an error that occurred due to one or more service quotas for an account.

Example

try:
  ...
except client.exceptions.ServiceQuotaExceededException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    Provides information about an error that occurred due to one or more service quotas for an account.

    • message (string) --

      The explanation of the error that occurred.

    • Error (dict) -- Normalized access to common exception attributes.

      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Macie2.Client.exceptions.ThrottlingException

Provides information about an error that occurred because too many requests were sent during a certain amount of time.

Example

try:
  ...
except client.exceptions.ThrottlingException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    Provides information about an error that occurred because too many requests were sent during a certain amount of time.

    • message (string) --

      The explanation of the error that occurred.

    • Error (dict) -- Normalized access to common exception attributes.

      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class Macie2.Client.exceptions.ValidationException

Provides information about an error that occurred due to a syntax error in a request.

Example

try:
  ...
except client.exceptions.ValidationException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    Provides information about an error that occurred due to a syntax error in a request.

    • message (string) --

      The explanation of the error that occurred.

    • Error (dict) -- Normalized access to common exception attributes.

      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.

Paginators

The available paginators are:

class Macie2.Paginator.DescribeBuckets
paginator = client.get_paginator('describe_buckets')
paginate(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    criteria={
        'string': {
            'eq': [
                'string',
            ],
            'gt': 123,
            'gte': 123,
            'lt': 123,
            'lte': 123,
            'neq': [
                'string',
            ],
            'prefix': 'string'
        }
    },
    sortCriteria={
        'attributeName': 'string',
        'orderBy': 'ASC'|'DESC'
    },
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • criteria (dict) --

    The criteria to use to filter the query results.

    • (string) --
      • (dict) --

        Specifies the operator to use in a property-based condition that filters the results of a query for information about S3 buckets.

        • eq (list) --

          The value for the property matches (equals) the specified value. If you specify multiple values, Amazon Macie uses OR logic to join the values.

          • (string) --
        • gt (integer) --

          The value for the property is greater than the specified value.

        • gte (integer) --

          The value for the property is greater than or equal to the specified value.

        • lt (integer) --

          The value for the property is less than the specified value.

        • lte (integer) --

          The value for the property is less than or equal to the specified value.

        • neq (list) --

          The value for the property doesn't match (doesn't equal) the specified value. If you specify multiple values, Amazon Macie uses OR logic to join the values.

          • (string) --
        • prefix (string) --

          The name of the bucket begins with the specified value.

  • sortCriteria (dict) --

    The criteria to use to sort the query results.

    • attributeName (string) --

      The name of the bucket property to sort the results by. This value can be one of the following properties that Amazon Macie defines as bucket metadata: accountId, bucketName, classifiableObjectCount, classifiableSizeInBytes, objectCount, or sizeInBytes.

    • orderBy (string) --

      The sort order to apply to the results, based on the value specified by the attributeName property. Valid values are: ASC, sort the results in ascending order; and, DESC, sort the results in descending order.

  • 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

{
    'buckets': [
        {
            'accountId': 'string',
            'allowsUnencryptedObjectUploads': 'TRUE'|'FALSE'|'UNKNOWN',
            'bucketArn': 'string',
            'bucketCreatedAt': datetime(2015, 1, 1),
            'bucketName': 'string',
            'classifiableObjectCount': 123,
            'classifiableSizeInBytes': 123,
            'errorCode': 'ACCESS_DENIED',
            'errorMessage': 'string',
            'jobDetails': {
                'isDefinedInJob': 'TRUE'|'FALSE'|'UNKNOWN',
                'isMonitoredByJob': 'TRUE'|'FALSE'|'UNKNOWN',
                'lastJobId': 'string',
                'lastJobRunTime': datetime(2015, 1, 1)
            },
            'lastUpdated': datetime(2015, 1, 1),
            'objectCount': 123,
            'objectCountByEncryptionType': {
                'customerManaged': 123,
                'kmsManaged': 123,
                's3Managed': 123,
                'unencrypted': 123,
                'unknown': 123
            },
            'publicAccess': {
                'effectivePermission': 'PUBLIC'|'NOT_PUBLIC'|'UNKNOWN',
                'permissionConfiguration': {
                    'accountLevelPermissions': {
                        'blockPublicAccess': {
                            'blockPublicAcls': True|False,
                            'blockPublicPolicy': True|False,
                            'ignorePublicAcls': True|False,
                            'restrictPublicBuckets': True|False
                        }
                    },
                    'bucketLevelPermissions': {
                        'accessControlList': {
                            'allowsPublicReadAccess': True|False,
                            'allowsPublicWriteAccess': True|False
                        },
                        'blockPublicAccess': {
                            'blockPublicAcls': True|False,
                            'blockPublicPolicy': True|False,
                            'ignorePublicAcls': True|False,
                            'restrictPublicBuckets': True|False
                        },
                        'bucketPolicy': {
                            'allowsPublicReadAccess': True|False,
                            'allowsPublicWriteAccess': True|False
                        }
                    }
                }
            },
            'region': 'string',
            'replicationDetails': {
                'replicated': True|False,
                'replicatedExternally': True|False,
                'replicationAccounts': [
                    'string',
                ]
            },
            'serverSideEncryption': {
                'kmsMasterKeyId': 'string',
                'type': 'NONE'|'AES256'|'aws:kms'
            },
            'sharedAccess': 'EXTERNAL'|'INTERNAL'|'NOT_SHARED'|'UNKNOWN',
            'sizeInBytes': 123,
            'sizeInBytesCompressed': 123,
            'tags': [
                {
                    'key': 'string',
                    'value': 'string'
                },
            ],
            'unclassifiableObjectCount': {
                'fileType': 123,
                'storageClass': 123,
                'total': 123
            },
            'unclassifiableObjectSizeInBytes': {
                'fileType': 123,
                'storageClass': 123,
                'total': 123
            },
            'versioning': True|False
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • buckets (list) --

      An array of objects, one for each bucket that meets the filter criteria specified in the request.

      • (dict) --

        Provides statistical data and other information about an S3 bucket that Amazon Macie monitors and analyzes for your account. If an error occurs when Macie attempts to retrieve and process information about the bucket or the bucket's objects, the value for most of these properties is null. Exceptions are accountId, bucketArn, bucketCreatedAt, bucketName, lastUpdated, and region. To identify the cause of the error, refer to the errorCode and errorMessage values.

        • accountId (string) --

          The unique identifier for the Amazon Web Services account that owns the bucket.

        • allowsUnencryptedObjectUploads (string) --

          Specifies whether the bucket policy for the bucket requires server-side encryption of objects when objects are uploaded to the bucket. Possible values are:

          • FALSE - The bucket policy requires server-side encryption of new objects. PutObject requests must include the x-amz-server-side-encryption header and the value for that header must be AES256 or aws:kms.
          • TRUE - The bucket doesn't have a bucket policy or it has a bucket policy that doesn't require server-side encryption of new objects. If a bucket policy exists, it doesn't require PutObject requests to include the x-amz-server-side-encryption header and it doesn't require the value for that header to be AES256 or aws:kms.
          • UNKNOWN - Amazon Macie can't determine whether the bucket policy requires server-side encryption of new objects.
        • bucketArn (string) --

          The Amazon Resource Name (ARN) of the bucket.

        • bucketCreatedAt (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when the bucket was created.

        • bucketName (string) --

          The name of the bucket.

        • classifiableObjectCount (integer) --

          The total number of objects that Amazon Macie can analyze in the bucket. These objects use a supported storage class and have a file name extension for a supported file or storage format.

        • classifiableSizeInBytes (integer) --

          The total storage size, in bytes, of the objects that Amazon Macie can analyze in the bucket. These objects use a supported storage class and have a file name extension for a supported file or storage format.

          If versioning is enabled for the bucket, Macie calculates this value based on the size of the latest version of each applicable object in the bucket. This value doesn't reflect the storage size of all versions of each applicable object in the bucket.

        • errorCode (string) --

          Specifies the error code for an error that prevented Amazon Macie from retrieving and processing information about the bucket and the bucket's objects. If this value is ACCESS_DENIED, Macie doesn't have permission to retrieve the information. For example, the bucket has a restrictive bucket policy and Amazon S3 denied the request. If this value is null, Macie was able to retrieve and process the information.

        • errorMessage (string) --

          A brief description of the error (errorCode) that prevented Amazon Macie from retrieving and processing information about the bucket and the bucket's objects. This value is null if Macie was able to retrieve and process the information.

        • jobDetails (dict) --

          Specifies whether any one-time or recurring classification jobs are configured to analyze data in the bucket, and, if so, the details of the job that ran most recently.

          • isDefinedInJob (string) --

            Specifies whether any one-time or recurring jobs are configured to analyze data in the bucket. Possible values are:

            • TRUE - The bucket is explicitly included in the bucket definition (S3BucketDefinitionForJob) for one or more jobs and at least one of those jobs has a status other than CANCELLED. Or the bucket matched the bucket criteria (S3BucketCriteriaForJob) for at least one job that previously ran.
            • FALSE - The bucket isn't explicitly included in the bucket definition (S3BucketDefinitionForJob) for any jobs, all the jobs that explicitly include the bucket in their bucket definitions have a status of CANCELLED, or the bucket didn't match the bucket criteria (S3BucketCriteriaForJob) for any jobs that previously ran.
            • UNKNOWN - An exception occurred when Amazon Macie attempted to retrieve job data for the bucket.
          • isMonitoredByJob (string) --

            Specifies whether any recurring jobs are configured to analyze data in the bucket. Possible values are:

            • TRUE - The bucket is explicitly included in the bucket definition (S3BucketDefinitionForJob) for one or more recurring jobs or the bucket matches the bucket criteria (S3BucketCriteriaForJob) for one or more recurring jobs. At least one of those jobs has a status other than CANCELLED.
            • FALSE - The bucket isn't explicitly included in the bucket definition (S3BucketDefinitionForJob) for any recurring jobs, the bucket doesn't match the bucket criteria (S3BucketCriteriaForJob) for any recurring jobs, or all the recurring jobs that are configured to analyze data in the bucket have a status of CANCELLED.
            • UNKNOWN - An exception occurred when Amazon Macie attempted to retrieve job data for the bucket.
          • lastJobId (string) --

            The unique identifier for the job that ran most recently and is configured to analyze data in the bucket, either the latest run of a recurring job or the only run of a one-time job.

            This value is typically null if the value for the isDefinedInJob property is FALSE or UNKNOWN.

          • lastJobRunTime (datetime) --

            The date and time, in UTC and extended ISO 8601 format, when the job (lastJobId) started. If the job is a recurring job, this value indicates when the most recent run started.

            This value is typically null if the value for the isDefinedInJob property is FALSE or UNKNOWN.

        • lastUpdated (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when Amazon Macie most recently retrieved both bucket and object metadata from Amazon S3 for the bucket.

        • objectCount (integer) --

          The total number of objects in the bucket.

        • objectCountByEncryptionType (dict) --

          The total number of objects that are in the bucket, grouped by server-side encryption type. This includes a grouping that reports the total number of objects that aren't encrypted or use client-side encryption.

          • customerManaged (integer) --

            The total number of objects that are encrypted with a customer-provided key. The objects use customer-provided server-side encryption (SSE-C).

          • kmsManaged (integer) --

            The total number of objects that are encrypted with an KMS key, either an Amazon Web Services managed key or a customer managed key. The objects use KMS encryption (SSE-KMS).

          • s3Managed (integer) --

            The total number of objects that are encrypted with an Amazon S3 managed key. The objects use Amazon S3 managed encryption (SSE-S3).

          • unencrypted (integer) --

            The total number of objects that aren't encrypted or use client-side encryption.

          • unknown (integer) --

            The total number of objects that Amazon Macie doesn't have current encryption metadata for. Macie can't provide current data about the encryption settings for these objects.

        • publicAccess (dict) --

          Specifies whether the bucket is publicly accessible due to the combination of permissions settings that apply to the bucket, and provides information about those settings.

          • effectivePermission (string) --

            Specifies whether the bucket is publicly accessible due to the combination of permissions settings that apply to the bucket. Possible values are:

            • NOT_PUBLIC - The bucket isn't publicly accessible.
            • PUBLIC - The bucket is publicly accessible.
            • UNKNOWN - Amazon Macie can't determine whether the bucket is publicly accessible.
          • permissionConfiguration (dict) --

            The account-level and bucket-level permissions settings for the bucket.

            • accountLevelPermissions (dict) --

              The account-level permissions settings that apply to the bucket.

              • blockPublicAccess (dict) --

                The block public access settings for the Amazon Web Services account that owns the bucket.

                • blockPublicAcls (boolean) --

                  Specifies whether Amazon S3 blocks public access control lists (ACLs) for the bucket and objects in the bucket.

                • blockPublicPolicy (boolean) --

                  Specifies whether Amazon S3 blocks public bucket policies for the bucket.

                • ignorePublicAcls (boolean) --

                  Specifies whether Amazon S3 ignores public ACLs for the bucket and objects in the bucket.

                • restrictPublicBuckets (boolean) --

                  Specifies whether Amazon S3 restricts public bucket policies for the bucket.

            • bucketLevelPermissions (dict) --

              The bucket-level permissions settings for the bucket.

              • accessControlList (dict) --

                The permissions settings of the access control list (ACL) for the bucket. This value is null if an ACL hasn't been defined for the bucket.

                • allowsPublicReadAccess (boolean) --

                  Specifies whether the ACL grants the general public with read access permissions for the bucket.

                • allowsPublicWriteAccess (boolean) --

                  Specifies whether the ACL grants the general public with write access permissions for the bucket.

              • blockPublicAccess (dict) --

                The block public access settings for the bucket.

                • blockPublicAcls (boolean) --

                  Specifies whether Amazon S3 blocks public access control lists (ACLs) for the bucket and objects in the bucket.

                • blockPublicPolicy (boolean) --

                  Specifies whether Amazon S3 blocks public bucket policies for the bucket.

                • ignorePublicAcls (boolean) --

                  Specifies whether Amazon S3 ignores public ACLs for the bucket and objects in the bucket.

                • restrictPublicBuckets (boolean) --

                  Specifies whether Amazon S3 restricts public bucket policies for the bucket.

              • bucketPolicy (dict) --

                The permissions settings of the bucket policy for the bucket. This value is null if a bucket policy hasn't been defined for the bucket.

                • allowsPublicReadAccess (boolean) --

                  Specifies whether the bucket policy allows the general public to have read access to the bucket.

                • allowsPublicWriteAccess (boolean) --

                  Specifies whether the bucket policy allows the general public to have write access to the bucket.

        • region (string) --

          The Amazon Web Services Region that hosts the bucket.

        • replicationDetails (dict) --

          Specifies whether the bucket is configured to replicate one or more objects to buckets for other Amazon Web Services accounts and, if so, which accounts.

          • replicated (boolean) --

            Specifies whether the bucket is configured to replicate one or more objects to any destination.

          • replicatedExternally (boolean) --

            Specifies whether the bucket is configured to replicate one or more objects to an Amazon Web Services account that isn't part of the same Amazon Macie organization.

          • replicationAccounts (list) --

            An array of Amazon Web Services account IDs, one for each Amazon Web Services account that the bucket is configured to replicate one or more objects to.

            • (string) --
        • serverSideEncryption (dict) --

          Specifies whether the bucket encrypts new objects by default and, if so, the type of server-side encryption that's used.

          • kmsMasterKeyId (string) --

            The Amazon Resource Name (ARN) or unique identifier (key ID) for the KMS key that's used by default to encrypt objects that are added to the bucket. This value is null if the bucket uses an Amazon S3 managed key to encrypt new objects or the bucket doesn't encrypt new objects by default.

          • type (string) --

            The type of server-side encryption that's used by default when storing new objects in the bucket. Possible values are:

            • AES256 - New objects are encrypted with an Amazon S3 managed key. They use SSE-S3 encryption.
            • aws:kms - New objects are encrypted with an KMS key (kmsMasterKeyId), either an Amazon Web Services managed key or a customer managed key. They use SSE-KMS encryption.
            • NONE - New objects aren't encrypted by default. Default encryption is disabled for the bucket.
        • sharedAccess (string) --

          Specifies whether the bucket is shared with another Amazon Web Services account. Possible values are:

          • EXTERNAL - The bucket is shared with an Amazon Web Services account that isn't part of the same Amazon Macie organization.
          • INTERNAL - The bucket is shared with an Amazon Web Services account that's part of the same Amazon Macie organization.
          • NOT_SHARED - The bucket isn't shared with other Amazon Web Services accounts.
          • UNKNOWN - Amazon Macie wasn't able to evaluate the shared access settings for the bucket.
        • sizeInBytes (integer) --

          The total storage size, in bytes, of the bucket.

          If versioning is enabled for the bucket, Amazon Macie calculates this value based on the size of the latest version of each object in the bucket. This value doesn't reflect the storage size of all versions of each object in the bucket.

        • sizeInBytesCompressed (integer) --

          The total storage size, in bytes, of the objects that are compressed (.gz, .gzip, .zip) files in the bucket.

          If versioning is enabled for the bucket, Amazon Macie calculates this value based on the size of the latest version of each applicable object in the bucket. This value doesn't reflect the storage size of all versions of each applicable object in the bucket.

        • tags (list) --

          An array that specifies the tags (keys and values) that are associated with the bucket.

          • (dict) --

            Provides information about the tags that are associated with an S3 bucket or object. Each tag consists of a required tag key and an associated tag value.

            • key (string) --

              One part of a key-value pair that comprises a tag. A tag key is a general label that acts as a category for more specific tag values.

            • value (string) --

              One part of a key-value pair that comprises a tag. A tag value acts as a descriptor for a tag key. A tag value can be an empty string.

        • unclassifiableObjectCount (dict) --

          The total number of objects that Amazon Macie can't analyze in the bucket. These objects don't use a supported storage class or don't have a file name extension for a supported file or storage format.

          • fileType (integer) --

            The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects don't have a file name extension for a supported file or storage format.

          • storageClass (integer) --

            The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class.

          • total (integer) --

            The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class or don't have a file name extension for a supported file or storage format.

        • unclassifiableObjectSizeInBytes (dict) --

          The total storage size, in bytes, of the objects that Amazon Macie can't analyze in the bucket. These objects don't use a supported storage class or don't have a file name extension for a supported file or storage format.

          • fileType (integer) --

            The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects don't have a file name extension for a supported file or storage format.

          • storageClass (integer) --

            The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class.

          • total (integer) --

            The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class or don't have a file name extension for a supported file or storage format.

        • versioning (boolean) --

          Specifies whether versioning is enabled for the bucket.

    • NextToken (string) --

      A token to resume pagination.

class Macie2.Paginator.GetUsageStatistics
paginator = client.get_paginator('get_usage_statistics')
paginate(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    filterBy=[
        {
            'comparator': 'GT'|'GTE'|'LT'|'LTE'|'EQ'|'NE'|'CONTAINS',
            'key': 'accountId'|'serviceLimit'|'freeTrialStartDate'|'total',
            'values': [
                'string',
            ]
        },
    ],
    sortBy={
        'key': 'accountId'|'total'|'serviceLimitValue'|'freeTrialStartDate',
        'orderBy': 'ASC'|'DESC'
    },
    timeRange='MONTH_TO_DATE'|'PAST_30_DAYS',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • filterBy (list) --

    An array of objects, one for each condition to use to filter the query results. If you specify more than one condition, Amazon Macie uses an AND operator to join the conditions.

    • (dict) --

      Specifies a condition for filtering the results of a query for quota and usage data for one or more Amazon Macie accounts.

      • comparator (string) --

        The operator to use in the condition. If the value for the key property is accountId, this value must be CONTAINS. If the value for the key property is any other supported field, this value can be EQ, GT, GTE, LT, LTE, or NE.

      • key (string) --

        The field to use in the condition.

      • values (list) --

        An array that lists values to use in the condition, based on the value for the field specified by the key property. If the value for the key property is accountId, this array can specify multiple values. Otherwise, this array can specify only one value.

        Valid values for each supported field are:

        • accountId - The unique identifier for an Amazon Web Services account.
        • freeTrialStartDate - The date and time, in UTC and extended ISO 8601 format, when the free trial started for an account.
        • serviceLimit - A Boolean (true or false) value that indicates whether an account has reached its monthly quota.
        • total - A string that represents the current estimated cost for an account.
        • (string) --
  • sortBy (dict) --

    The criteria to use to sort the query results.

    • key (string) --

      The field to sort the results by.

    • orderBy (string) --

      The sort order to apply to the results, based on the value for the field specified by the key property. Valid values are: ASC, sort the results in ascending order; and, DESC, sort the results in descending order.

  • timeRange (string) -- The inclusive time period to query usage data for. Valid values are: MONTH_TO_DATE, for the current calendar month to date; and, PAST_30_DAYS, for the preceding 30 days. If you don't specify a value, Amazon Macie provides usage data for the preceding 30 days.
  • 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

{
    'records': [
        {
            'accountId': 'string',
            'freeTrialStartDate': datetime(2015, 1, 1),
            'usage': [
                {
                    'currency': 'USD',
                    'estimatedCost': 'string',
                    'serviceLimit': {
                        'isServiceLimited': True|False,
                        'unit': 'TERABYTES',
                        'value': 123
                    },
                    'type': 'DATA_INVENTORY_EVALUATION'|'SENSITIVE_DATA_DISCOVERY'
                },
            ]
        },
    ],
    'timeRange': 'MONTH_TO_DATE'|'PAST_30_DAYS',
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • records (list) --

      An array of objects that contains the results of the query. Each object contains the data for an account that meets the filter criteria specified in the request.

      • (dict) --

        Provides quota and aggregated usage data for an Amazon Macie account.

        • accountId (string) --

          The unique identifier for the Amazon Web Services account that the data applies to.

        • freeTrialStartDate (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when the free trial started for the account.

        • usage (list) --

          An array of objects that contains usage data and quotas for the account. Each object contains the data for a specific usage metric and the corresponding quota.

          • (dict) --

            Provides data for a specific usage metric and the corresponding quota for an Amazon Macie account.

            • currency (string) --

              The type of currency that the value for the metric (estimatedCost) is reported in.

            • estimatedCost (string) --

              The estimated value for the metric.

            • serviceLimit (dict) --

              The current value for the quota that corresponds to the metric specified by the type field.

              • isServiceLimited (boolean) --

                Specifies whether the account has met the quota that corresponds to the metric specified by the UsageByAccount.type field in the response.

              • unit (string) --

                The unit of measurement for the value specified by the value field.

              • value (integer) --

                The value for the metric specified by the UsageByAccount.type field in the response.

            • type (string) --

              The name of the metric. Possible values are: DATA_INVENTORY_EVALUATION, for monitoring S3 buckets; and, SENSITIVE_DATA_DISCOVERY, for analyzing S3 objects to detect sensitive data.

    • timeRange (string) --

      The inclusive time period that the usage data applies to. Possible values are: MONTH_TO_DATE, for the current calendar month to date; and, PAST_30_DAYS, for the preceding 30 days.

    • NextToken (string) --

      A token to resume pagination.

class Macie2.Paginator.ListClassificationJobs
paginator = client.get_paginator('list_classification_jobs')
paginate(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    filterCriteria={
        'excludes': [
            {
                'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                'key': 'jobType'|'jobStatus'|'createdAt'|'name',
                'values': [
                    'string',
                ]
            },
        ],
        'includes': [
            {
                'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                'key': 'jobType'|'jobStatus'|'createdAt'|'name',
                'values': [
                    'string',
                ]
            },
        ]
    },
    sortCriteria={
        'attributeName': 'createdAt'|'jobStatus'|'name'|'jobType',
        'orderBy': 'ASC'|'DESC'
    },
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • filterCriteria (dict) --

    The criteria to use to filter the results.

    • excludes (list) --

      An array of objects, one for each condition that determines which jobs to exclude from the results.

      • (dict) --

        Specifies a condition that filters the results of a request for information about classification jobs. Each condition consists of a property, an operator, and one or more values.

        • comparator (string) --

          The operator to use to filter the results.

        • key (string) --

          The property to use to filter the results.

        • values (list) --

          An array that lists one or more values to use to filter the results.

          • (string) --
    • includes (list) --

      An array of objects, one for each condition that determines which jobs to include in the results.

      • (dict) --

        Specifies a condition that filters the results of a request for information about classification jobs. Each condition consists of a property, an operator, and one or more values.

        • comparator (string) --

          The operator to use to filter the results.

        • key (string) --

          The property to use to filter the results.

        • values (list) --

          An array that lists one or more values to use to filter the results.

          • (string) --
  • sortCriteria (dict) --

    The criteria to use to sort the results.

    • attributeName (string) --

      The property to sort the results by.

    • orderBy (string) --

      The sort order to apply to the results, based on the value for the property specified by the attributeName property. Valid values are: ASC, sort the results in ascending order; and, DESC, sort the results in descending order.

  • 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

{
    'items': [
        {
            'bucketDefinitions': [
                {
                    'accountId': 'string',
                    'buckets': [
                        'string',
                    ]
                },
            ],
            'createdAt': datetime(2015, 1, 1),
            'jobId': 'string',
            'jobStatus': 'RUNNING'|'PAUSED'|'CANCELLED'|'COMPLETE'|'IDLE'|'USER_PAUSED',
            'jobType': 'ONE_TIME'|'SCHEDULED',
            'lastRunErrorStatus': {
                'code': 'NONE'|'ERROR'
            },
            'name': 'string',
            'userPausedDetails': {
                'jobExpiresAt': datetime(2015, 1, 1),
                'jobImminentExpirationHealthEventArn': 'string',
                'jobPausedAt': datetime(2015, 1, 1)
            },
            'bucketCriteria': {
                'excludes': {
                    'and': [
                        {
                            'simpleCriterion': {
                                'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                                'key': 'ACCOUNT_ID'|'S3_BUCKET_NAME'|'S3_BUCKET_EFFECTIVE_PERMISSION'|'S3_BUCKET_SHARED_ACCESS',
                                'values': [
                                    'string',
                                ]
                            },
                            'tagCriterion': {
                                'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                                'tagValues': [
                                    {
                                        'key': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                },
                'includes': {
                    'and': [
                        {
                            'simpleCriterion': {
                                'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                                'key': 'ACCOUNT_ID'|'S3_BUCKET_NAME'|'S3_BUCKET_EFFECTIVE_PERMISSION'|'S3_BUCKET_SHARED_ACCESS',
                                'values': [
                                    'string',
                                ]
                            },
                            'tagCriterion': {
                                'comparator': 'EQ'|'GT'|'GTE'|'LT'|'LTE'|'NE'|'CONTAINS'|'STARTS_WITH',
                                'tagValues': [
                                    {
                                        'key': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                    ]
                }
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • items (list) --

      An array of objects, one for each job that meets the filter criteria specified in the request.

      • (dict) --

        Provides information about a classification job, including the current status of the job.

        • bucketDefinitions (list) --

          An array of objects, one for each Amazon Web Services account that owns specific S3 buckets for the job to analyze. Each object specifies the account ID for an account and one or more buckets to analyze for that account. A job's definition can contain a bucketDefinitions array or a bucketCriteria object, not both.

          • (dict) --

            Specifies an Amazon Web Services account that owns S3 buckets for a classification job to analyze, and one or more specific buckets to analyze for that account.

            • accountId (string) --

              The unique identifier for the Amazon Web Services account that owns the buckets.

            • buckets (list) --

              An array that lists the names of the buckets.

              • (string) --
        • createdAt (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when the job was created.

        • jobId (string) --

          The unique identifier for the job.

        • jobStatus (string) --

          The current status of the job. Possible values are:

          • CANCELLED - You cancelled the job or, if it's a one-time job, you paused the job and didn't resume it within 30 days.
          • COMPLETE - For a one-time job, Amazon Macie finished processing the data specified for the job. This value doesn't apply to recurring jobs.
          • IDLE - For a recurring job, the previous scheduled run is complete and the next scheduled run is pending. This value doesn't apply to one-time jobs.
          • PAUSED - Macie started running the job but additional processing would exceed the monthly sensitive data discovery quota for your account or one or more member accounts that the job analyzes data for.
          • RUNNING - For a one-time job, the job is in progress. For a recurring job, a scheduled run is in progress.
          • USER_PAUSED - You paused the job. If you paused the job while it had a status of RUNNING and you don't resume it within 30 days of pausing it, the job or job run will expire and be cancelled, depending on the job's type. To check the expiration date, refer to the UserPausedDetails.jobExpiresAt property.
        • jobType (string) --

          The schedule for running the job. Possible values are:

          • ONE_TIME - The job runs only once.
          • SCHEDULED - The job runs on a daily, weekly, or monthly basis.
        • lastRunErrorStatus (dict) --

          Specifies whether any account- or bucket-level access errors occurred when the job ran. For a recurring job, this value indicates the error status of the job's most recent run.

          • code (string) --

            Specifies whether any account- or bucket-level access errors occurred when the job ran. For a recurring job, this value indicates the error status of the job's most recent run. Possible values are:

            • ERROR - One or more errors occurred. Amazon Macie didn't process all the data specified for the job.
            • NONE - No errors occurred. Macie processed all the data specified for the job.
        • name (string) --

          The custom name of the job.

        • userPausedDetails (dict) --

          If the current status of the job is USER_PAUSED, specifies when the job was paused and when the job or job run will expire and be cancelled if it isn't resumed. This value is present only if the value for jobStatus is USER_PAUSED.

          • jobExpiresAt (datetime) --

            The date and time, in UTC and extended ISO 8601 format, when the job or job run will expire and be cancelled if you don't resume it first.

          • jobImminentExpirationHealthEventArn (string) --

            The Amazon Resource Name (ARN) of the Health event that Amazon Macie sent to notify you of the job or job run's pending expiration and cancellation. This value is null if a job has been paused for less than 23 days.

          • jobPausedAt (datetime) --

            The date and time, in UTC and extended ISO 8601 format, when you paused the job.

        • bucketCriteria (dict) --

          The property- and tag-based conditions that determine which S3 buckets are included or excluded from the job's analysis. Each time the job runs, the job uses these criteria to determine which buckets to analyze. A job's definition can contain a bucketCriteria object or a bucketDefinitions array, not both.

          • excludes (dict) --

            The property- and tag-based conditions that determine which buckets to exclude from the job.

            • and (list) --

              An array of conditions, one for each condition that determines which buckets to include or exclude from the job. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

              • (dict) --

                Specifies a property- or tag-based condition that defines criteria for including or excluding S3 buckets from a classification job.

                • simpleCriterion (dict) --

                  A property-based condition that defines a property, operator, and one or more values for including or excluding buckets from the job.

                  • comparator (string) --

                    The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

                  • key (string) --

                    The property to use in the condition.

                  • values (list) --

                    An array that lists one or more values to use in the condition. If you specify multiple values, Amazon Macie uses OR logic to join the values. Valid values for each supported property (key) are:

                    • ACCOUNT_ID - A string that represents the unique identifier for the Amazon Web Services account that owns the bucket.
                    • S3_BUCKET_EFFECTIVE_PERMISSION - A string that represents an enumerated value that Macie defines for the BucketPublicAccess.effectivePermission property of a bucket.
                    • S3_BUCKET_NAME - A string that represents the name of a bucket.
                    • S3_BUCKET_SHARED_ACCESS - A string that represents an enumerated value that Macie defines for the BucketMetadata.sharedAccess property of a bucket.

                    Values are case sensitive. Also, Macie doesn't support use of partial values or wildcard characters in these values.

                    • (string) --
                • tagCriterion (dict) --

                  A tag-based condition that defines an operator and tag keys, tag values, or tag key and value pairs for including or excluding buckets from the job.

                  • comparator (string) --

                    The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

                  • tagValues (list) --

                    The tag keys, tag values, or tag key and value pairs to use in the condition.

                    • (dict) --

                      Specifies a tag key, a tag value, or a tag key and value (as a pair) to use in a tag-based condition that determines whether an S3 bucket is included or excluded from a classification job. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based conditions.

                      • key (string) --

                        The value for the tag key to use in the condition.

                      • value (string) --

                        The tag value to use in the condition.

          • includes (dict) --

            The property- and tag-based conditions that determine which buckets to include in the job.

            • and (list) --

              An array of conditions, one for each condition that determines which buckets to include or exclude from the job. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

              • (dict) --

                Specifies a property- or tag-based condition that defines criteria for including or excluding S3 buckets from a classification job.

                • simpleCriterion (dict) --

                  A property-based condition that defines a property, operator, and one or more values for including or excluding buckets from the job.

                  • comparator (string) --

                    The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

                  • key (string) --

                    The property to use in the condition.

                  • values (list) --

                    An array that lists one or more values to use in the condition. If you specify multiple values, Amazon Macie uses OR logic to join the values. Valid values for each supported property (key) are:

                    • ACCOUNT_ID - A string that represents the unique identifier for the Amazon Web Services account that owns the bucket.
                    • S3_BUCKET_EFFECTIVE_PERMISSION - A string that represents an enumerated value that Macie defines for the BucketPublicAccess.effectivePermission property of a bucket.
                    • S3_BUCKET_NAME - A string that represents the name of a bucket.
                    • S3_BUCKET_SHARED_ACCESS - A string that represents an enumerated value that Macie defines for the BucketMetadata.sharedAccess property of a bucket.

                    Values are case sensitive. Also, Macie doesn't support use of partial values or wildcard characters in these values.

                    • (string) --
                • tagCriterion (dict) --

                  A tag-based condition that defines an operator and tag keys, tag values, or tag key and value pairs for including or excluding buckets from the job.

                  • comparator (string) --

                    The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

                  • tagValues (list) --

                    The tag keys, tag values, or tag key and value pairs to use in the condition.

                    • (dict) --

                      Specifies a tag key, a tag value, or a tag key and value (as a pair) to use in a tag-based condition that determines whether an S3 bucket is included or excluded from a classification job. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based conditions.

                      • key (string) --

                        The value for the tag key to use in the condition.

                      • value (string) --

                        The tag value to use in the condition.

    • NextToken (string) --

      A token to resume pagination.

class Macie2.Paginator.ListCustomDataIdentifiers
paginator = client.get_paginator('list_custom_data_identifiers')
paginate(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
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
{
    'items': [
        {
            'arn': 'string',
            'createdAt': datetime(2015, 1, 1),
            'description': 'string',
            'id': 'string',
            'name': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • items (list) --

      An array of objects, one for each custom data identifier.

      • (dict) --

        Provides information about a custom data identifier.

        • arn (string) --

          The Amazon Resource Name (ARN) of the custom data identifier.

        • createdAt (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when the custom data identifier was created.

        • description (string) --

          The custom description of the custom data identifier.

        • id (string) --

          The unique identifier for the custom data identifier.

        • name (string) --

          The custom name of the custom data identifier.

    • NextToken (string) --

      A token to resume pagination.

class Macie2.Paginator.ListFindings
paginator = client.get_paginator('list_findings')
paginate(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    findingCriteria={
        'criterion': {
            'string': {
                'eq': [
                    'string',
                ],
                'eqExactMatch': [
                    'string',
                ],
                'gt': 123,
                'gte': 123,
                'lt': 123,
                'lte': 123,
                'neq': [
                    'string',
                ]
            }
        }
    },
    sortCriteria={
        'attributeName': 'string',
        'orderBy': 'ASC'|'DESC'
    },
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • findingCriteria (dict) --

    The criteria to use to filter the results.

    • criterion (dict) --

      A condition that specifies the property, operator, and one or more values to use to filter the results.

      • (string) --
        • (dict) --

          Specifies the operator to use in a property-based condition that filters the results of a query for findings. For detailed information and examples of each operator, see Fundamentals of filtering findings in the Amazon Macie User Guide .

          • eq (list) --

            The value for the property matches (equals) the specified value. If you specify multiple values, Macie uses OR logic to join the values.

            • (string) --
          • eqExactMatch (list) --

            The value for the property exclusively matches (equals an exact match for) all the specified values. If you specify multiple values, Amazon Macie uses AND logic to join the values.

            You can use this operator with the following properties: customDataIdentifiers.detections.arn, customDataIdentifiers.detections.name, resourcesAffected.s3Bucket.tags.key, resourcesAffected.s3Bucket.tags.value, resourcesAffected.s3Object.tags.key, resourcesAffected.s3Object.tags.value, sensitiveData.category, and sensitiveData.detections.type.

            • (string) --
          • gt (integer) --

            The value for the property is greater than the specified value.

          • gte (integer) --

            The value for the property is greater than or equal to the specified value.

          • lt (integer) --

            The value for the property is less than the specified value.

          • lte (integer) --

            The value for the property is less than or equal to the specified value.

          • neq (list) --

            The value for the property doesn't match (doesn't equal) the specified value. If you specify multiple values, Macie uses OR logic to join the values.

            • (string) --
  • sortCriteria (dict) --

    The criteria to use to sort the results.

    • attributeName (string) --

      The name of the property to sort the results by. This value can be the name of any property that Amazon Macie defines for a finding.

    • orderBy (string) --

      The sort order to apply to the results, based on the value for the property specified by the attributeName property. Valid values are: ASC, sort the results in ascending order; and, DESC, sort the results in descending order.

  • 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

{
    'findingIds': [
        'string',
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • findingIds (list) --

      An array of strings, where each string is the unique identifier for a finding that meets the filter criteria specified in the request.

      • (string) --
    • NextToken (string) --

      A token to resume pagination.

class Macie2.Paginator.ListFindingsFilters
paginator = client.get_paginator('list_findings_filters')
paginate(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
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
{
    'findingsFilterListItems': [
        {
            'action': 'ARCHIVE'|'NOOP',
            'arn': 'string',
            'id': 'string',
            'name': 'string',
            'tags': {
                'string': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • findingsFilterListItems (list) --

      An array of objects, one for each filter that's associated with the account.

      • (dict) --

        Provides information about a findings filter.

        • action (string) --

          The action that's performed on findings that meet the filter criteria. Possible values are: ARCHIVE, suppress (automatically archive) the findings; and, NOOP, don't perform any action on the findings.

        • arn (string) --

          The Amazon Resource Name (ARN) of the filter.

        • id (string) --

          The unique identifier for the filter.

        • name (string) --

          The custom name of the filter.

        • tags (dict) --

          A map of key-value pairs that identifies the tags (keys and values) that are associated with the filter.

          • (string) --
            • (string) --
    • NextToken (string) --

      A token to resume pagination.

class Macie2.Paginator.ListInvitations
paginator = client.get_paginator('list_invitations')
paginate(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
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
{
    'invitations': [
        {
            'accountId': 'string',
            'invitationId': 'string',
            'invitedAt': datetime(2015, 1, 1),
            'relationshipStatus': 'Enabled'|'Paused'|'Invited'|'Created'|'Removed'|'Resigned'|'EmailVerificationInProgress'|'EmailVerificationFailed'|'RegionDisabled'|'AccountSuspended'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • invitations (list) --

      An array of objects, one for each invitation that was received by the account.

      • (dict) --

        Provides information about an Amazon Macie membership invitation that was received by an account.

        • accountId (string) --

          The Amazon Web Services account ID for the account that sent the invitation.

        • invitationId (string) --

          The unique identifier for the invitation. Amazon Macie uses this identifier to validate the inviter account with the invitee account.

        • invitedAt (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when the invitation was sent.

        • relationshipStatus (string) --

          The status of the relationship between the account that sent the invitation (inviter account ) and the account that received the invitation (invitee account ).

    • NextToken (string) --

      A token to resume pagination.

class Macie2.Paginator.ListMembers
paginator = client.get_paginator('list_members')
paginate(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    onlyAssociated='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • onlyAssociated (string) -- Specifies which accounts to include in the response, based on the status of an account's relationship with the administrator account. By default, the response includes only current member accounts. To include all accounts, set this value to false.
  • 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

{
    'members': [
        {
            'accountId': 'string',
            'administratorAccountId': 'string',
            'arn': 'string',
            'email': 'string',
            'invitedAt': datetime(2015, 1, 1),
            'masterAccountId': 'string',
            'relationshipStatus': 'Enabled'|'Paused'|'Invited'|'Created'|'Removed'|'Resigned'|'EmailVerificationInProgress'|'EmailVerificationFailed'|'RegionDisabled'|'AccountSuspended',
            'tags': {
                'string': 'string'
            },
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • members (list) --

      An array of objects, one for each account that's associated with the administrator account and meets the criteria specified by the onlyAssociated request parameter.

      • (dict) --

        Provides information about an account that's associated with an Amazon Macie administrator account.

        • accountId (string) --

          The Amazon Web Services account ID for the account.

        • administratorAccountId (string) --

          The Amazon Web Services account ID for the administrator account.

        • arn (string) --

          The Amazon Resource Name (ARN) of the account.

        • email (string) --

          The email address for the account.

        • invitedAt (datetime) --

          The date and time, in UTC and extended ISO 8601 format, when an Amazon Macie membership invitation was last sent to the account. This value is null if a Macie invitation hasn't been sent to the account.

        • masterAccountId (string) --

          (Deprecated) The Amazon Web Services account ID for the administrator account. This property has been replaced by the administratorAccountId property and is retained only for backward compatibility.

        • relationshipStatus (string) --

          The current status of the relationship between the account and the administrator account.

        • tags (dict) --

          A map of key-value pairs that identifies the tags (keys and values) that are associated with the account in Amazon Macie.

          • (string) --
            • (string) --
        • updatedAt (datetime) --

          The date and time, in UTC and extended ISO 8601 format, of the most recent change to the status of the relationship between the account and the administrator account.

    • NextToken (string) --

      A token to resume pagination.

class Macie2.Paginator.ListOrganizationAdminAccounts
paginator = client.get_paginator('list_organization_admin_accounts')
paginate(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
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
{
    'adminAccounts': [
        {
            'accountId': 'string',
            'status': 'ENABLED'|'DISABLING_IN_PROGRESS'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • adminAccounts (list) --

      An array of objects, one for each delegated Amazon Macie administrator account for the organization. Only one of these accounts can have a status of ENABLED.

      • (dict) --

        Provides information about the delegated Amazon Macie administrator account for an Amazon Web Services organization.

        • accountId (string) --

          The Amazon Web Services account ID for the account.

        • status (string) --

          The current status of the account as the delegated administrator of Amazon Macie for the organization.

    • NextToken (string) --

      A token to resume pagination.

class Macie2.Paginator.SearchResources
paginator = client.get_paginator('search_resources')
paginate(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    bucketCriteria={
        'excludes': {
            'and': [
                {
                    'simpleCriterion': {
                        'comparator': 'EQ'|'NE',
                        'key': 'ACCOUNT_ID'|'S3_BUCKET_NAME'|'S3_BUCKET_EFFECTIVE_PERMISSION'|'S3_BUCKET_SHARED_ACCESS',
                        'values': [
                            'string',
                        ]
                    },
                    'tagCriterion': {
                        'comparator': 'EQ'|'NE',
                        'tagValues': [
                            {
                                'key': 'string',
                                'value': 'string'
                            },
                        ]
                    }
                },
            ]
        },
        'includes': {
            'and': [
                {
                    'simpleCriterion': {
                        'comparator': 'EQ'|'NE',
                        'key': 'ACCOUNT_ID'|'S3_BUCKET_NAME'|'S3_BUCKET_EFFECTIVE_PERMISSION'|'S3_BUCKET_SHARED_ACCESS',
                        'values': [
                            'string',
                        ]
                    },
                    'tagCriterion': {
                        'comparator': 'EQ'|'NE',
                        'tagValues': [
                            {
                                'key': 'string',
                                'value': 'string'
                            },
                        ]
                    }
                },
            ]
        }
    },
    sortCriteria={
        'attributeName': 'ACCOUNT_ID'|'RESOURCE_NAME'|'S3_CLASSIFIABLE_OBJECT_COUNT'|'S3_CLASSIFIABLE_SIZE_IN_BYTES',
        'orderBy': 'ASC'|'DESC'
    },
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • bucketCriteria (dict) --

    The filter conditions that determine which S3 buckets to include or exclude from the query results.

    • excludes (dict) --

      The property- and tag-based conditions that determine which buckets to exclude from the results.

      • and (list) --

        An array of objects, one for each property- or tag-based condition that includes or excludes resources from the query results. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

        • (dict) --

          Specifies a property- or tag-based filter condition for including or excluding Amazon Web Services resources from the query results.

          • simpleCriterion (dict) --

            A property-based condition that defines a property, operator, and one or more values for including or excluding resources from the results.

            • comparator (string) --

              The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

            • key (string) --

              The property to use in the condition.

            • values (list) --

              An array that lists one or more values to use in the condition. If you specify multiple values, Amazon Macie uses OR logic to join the values. Valid values for each supported property (key) are:

              • ACCOUNT_ID - A string that represents the unique identifier for the Amazon Web Services account that owns the resource.
              • S3_BUCKET_EFFECTIVE_PERMISSION - A string that represents an enumerated value that Macie defines for the BucketPublicAccess.effectivePermission property of an S3 bucket.
              • S3_BUCKET_NAME - A string that represents the name of an S3 bucket.
              • S3_BUCKET_SHARED_ACCESS - A string that represents an enumerated value that Macie defines for the BucketMetadata.sharedAccess property of an S3 bucket.

              Values are case sensitive. Also, Macie doesn't support use of partial values or wildcard characters in values.

              • (string) --
          • tagCriterion (dict) --

            A tag-based condition that defines an operator and tag keys, tag values, or tag key and value pairs for including or excluding resources from the results.

            • comparator (string) --

              The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

            • tagValues (list) --

              The tag keys, tag values, or tag key and value pairs to use in the condition.

              • (dict) --

                Specifies a tag key, a tag value, or a tag key and value (as a pair) to use in a tag-based filter condition for a query. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based filter conditions.

                • key (string) --

                  The value for the tag key to use in the condition.

                • value (string) --

                  The tag value to use in the condition.

    • includes (dict) --

      The property- and tag-based conditions that determine which buckets to include in the results.

      • and (list) --

        An array of objects, one for each property- or tag-based condition that includes or excludes resources from the query results. If you specify more than one condition, Amazon Macie uses AND logic to join the conditions.

        • (dict) --

          Specifies a property- or tag-based filter condition for including or excluding Amazon Web Services resources from the query results.

          • simpleCriterion (dict) --

            A property-based condition that defines a property, operator, and one or more values for including or excluding resources from the results.

            • comparator (string) --

              The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

            • key (string) --

              The property to use in the condition.

            • values (list) --

              An array that lists one or more values to use in the condition. If you specify multiple values, Amazon Macie uses OR logic to join the values. Valid values for each supported property (key) are:

              • ACCOUNT_ID - A string that represents the unique identifier for the Amazon Web Services account that owns the resource.
              • S3_BUCKET_EFFECTIVE_PERMISSION - A string that represents an enumerated value that Macie defines for the BucketPublicAccess.effectivePermission property of an S3 bucket.
              • S3_BUCKET_NAME - A string that represents the name of an S3 bucket.
              • S3_BUCKET_SHARED_ACCESS - A string that represents an enumerated value that Macie defines for the BucketMetadata.sharedAccess property of an S3 bucket.

              Values are case sensitive. Also, Macie doesn't support use of partial values or wildcard characters in values.

              • (string) --
          • tagCriterion (dict) --

            A tag-based condition that defines an operator and tag keys, tag values, or tag key and value pairs for including or excluding resources from the results.

            • comparator (string) --

              The operator to use in the condition. Valid values are EQ (equals) and NE (not equals).

            • tagValues (list) --

              The tag keys, tag values, or tag key and value pairs to use in the condition.

              • (dict) --

                Specifies a tag key, a tag value, or a tag key and value (as a pair) to use in a tag-based filter condition for a query. Tag keys and values are case sensitive. Also, Amazon Macie doesn't support use of partial values or wildcard characters in tag-based filter conditions.

                • key (string) --

                  The value for the tag key to use in the condition.

                • value (string) --

                  The tag value to use in the condition.

  • sortCriteria (dict) --

    The criteria to use to sort the results.

    • attributeName (string) --

      The property to sort the results by.

    • orderBy (string) --

      The sort order to apply to the results, based on the value for the property specified by the attributeName property. Valid values are: ASC, sort the results in ascending order; and, DESC, sort the results in descending order.

  • 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

{
    'matchingResources': [
        {
            'matchingBucket': {
                'accountId': 'string',
                'bucketName': 'string',
                'classifiableObjectCount': 123,
                'classifiableSizeInBytes': 123,
                'errorCode': 'ACCESS_DENIED',
                'errorMessage': 'string',
                'jobDetails': {
                    'isDefinedInJob': 'TRUE'|'FALSE'|'UNKNOWN',
                    'isMonitoredByJob': 'TRUE'|'FALSE'|'UNKNOWN',
                    'lastJobId': 'string',
                    'lastJobRunTime': datetime(2015, 1, 1)
                },
                'objectCount': 123,
                'objectCountByEncryptionType': {
                    'customerManaged': 123,
                    'kmsManaged': 123,
                    's3Managed': 123,
                    'unencrypted': 123,
                    'unknown': 123
                },
                'sizeInBytes': 123,
                'sizeInBytesCompressed': 123,
                'unclassifiableObjectCount': {
                    'fileType': 123,
                    'storageClass': 123,
                    'total': 123
                },
                'unclassifiableObjectSizeInBytes': {
                    'fileType': 123,
                    'storageClass': 123,
                    'total': 123
                }
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    The request succeeded.

    • matchingResources (list) --

      An array of objects, one for each resource that meets the filter criteria specified in the request.

      • (dict) --

        Provides statistical data and other information about an Amazon Web Services resource that Amazon Macie monitors and analyzes for your account.

        • matchingBucket (dict) --

          The details of an S3 bucket that Amazon Macie monitors and analyzes.

          • accountId (string) --

            The unique identifier for the Amazon Web Services account that owns the bucket.

          • bucketName (string) --

            The name of the bucket.

          • classifiableObjectCount (integer) --

            The total number of objects that Amazon Macie can analyze in the bucket. These objects use a supported storage class and have a file name extension for a supported file or storage format.

          • classifiableSizeInBytes (integer) --

            The total storage size, in bytes, of the objects that Amazon Macie can analyze in the bucket. These objects use a supported storage class and have a file name extension for a supported file or storage format.

            If versioning is enabled for the bucket, Macie calculates this value based on the size of the latest version of each applicable object in the bucket. This value doesn't reflect the storage size of all versions of each applicable object in the bucket.

          • errorCode (string) --

            Specifies the error code for an error that prevented Amazon Macie from retrieving and processing information about the bucket and the bucket's objects. If this value is ACCESS_DENIED, Macie doesn't have permission to retrieve the information. For example, the bucket has a restrictive bucket policy and Amazon S3 denied the request. If this value is null, Macie was able to retrieve and process the information.

          • errorMessage (string) --

            A brief description of the error (errorCode) that prevented Amazon Macie from retrieving and processing information about the bucket and the bucket's objects. This value is null if Macie was able to retrieve and process the information.

          • jobDetails (dict) --

            Specifies whether any one-time or recurring classification jobs are configured to analyze objects in the bucket, and, if so, the details of the job that ran most recently.

            • isDefinedInJob (string) --

              Specifies whether any one-time or recurring jobs are configured to analyze data in the bucket. Possible values are:

              • TRUE - The bucket is explicitly included in the bucket definition (S3BucketDefinitionForJob) for one or more jobs and at least one of those jobs has a status other than CANCELLED. Or the bucket matched the bucket criteria (S3BucketCriteriaForJob) for at least one job that previously ran.
              • FALSE - The bucket isn't explicitly included in the bucket definition (S3BucketDefinitionForJob) for any jobs, all the jobs that explicitly include the bucket in their bucket definitions have a status of CANCELLED, or the bucket didn't match the bucket criteria (S3BucketCriteriaForJob) for any jobs that previously ran.
              • UNKNOWN - An exception occurred when Amazon Macie attempted to retrieve job data for the bucket.
            • isMonitoredByJob (string) --

              Specifies whether any recurring jobs are configured to analyze data in the bucket. Possible values are:

              • TRUE - The bucket is explicitly included in the bucket definition (S3BucketDefinitionForJob) for one or more recurring jobs or the bucket matches the bucket criteria (S3BucketCriteriaForJob) for one or more recurring jobs. At least one of those jobs has a status other than CANCELLED.
              • FALSE - The bucket isn't explicitly included in the bucket definition (S3BucketDefinitionForJob) for any recurring jobs, the bucket doesn't match the bucket criteria (S3BucketCriteriaForJob) for any recurring jobs, or all the recurring jobs that are configured to analyze data in the bucket have a status of CANCELLED.
              • UNKNOWN - An exception occurred when Amazon Macie attempted to retrieve job data for the bucket.
            • lastJobId (string) --

              The unique identifier for the job that ran most recently and is configured to analyze data in the bucket, either the latest run of a recurring job or the only run of a one-time job.

              This value is typically null if the value for the isDefinedInJob property is FALSE or UNKNOWN.

            • lastJobRunTime (datetime) --

              The date and time, in UTC and extended ISO 8601 format, when the job (lastJobId) started. If the job is a recurring job, this value indicates when the most recent run started.

              This value is typically null if the value for the isDefinedInJob property is FALSE or UNKNOWN.

          • objectCount (integer) --

            The total number of objects in the bucket.

          • objectCountByEncryptionType (dict) --

            The total number of objects that are in the bucket, grouped by server-side encryption type. This includes a grouping that reports the total number of objects that aren't encrypted or use client-side encryption.

            • customerManaged (integer) --

              The total number of objects that are encrypted with a customer-provided key. The objects use customer-provided server-side encryption (SSE-C).

            • kmsManaged (integer) --

              The total number of objects that are encrypted with an KMS key, either an Amazon Web Services managed key or a customer managed key. The objects use KMS encryption (SSE-KMS).

            • s3Managed (integer) --

              The total number of objects that are encrypted with an Amazon S3 managed key. The objects use Amazon S3 managed encryption (SSE-S3).

            • unencrypted (integer) --

              The total number of objects that aren't encrypted or use client-side encryption.

            • unknown (integer) --

              The total number of objects that Amazon Macie doesn't have current encryption metadata for. Macie can't provide current data about the encryption settings for these objects.

          • sizeInBytes (integer) --

            The total storage size, in bytes, of the bucket.

            If versioning is enabled for the bucket, Amazon Macie calculates this value based on the size of the latest version of each object in the bucket. This value doesn't reflect the storage size of all versions of each object in the bucket.

          • sizeInBytesCompressed (integer) --

            The total storage size, in bytes, of the objects that are compressed (.gz, .gzip, .zip) files in the bucket.

            If versioning is enabled for the bucket, Amazon Macie calculates this value based on the size of the latest version of each applicable object in the bucket. This value doesn't reflect the storage size of all versions of each applicable object in the bucket.

          • unclassifiableObjectCount (dict) --

            The total number of objects that Amazon Macie can't analyze in the bucket. These objects don't use a supported storage class or don't have a file name extension for a supported file or storage format.

            • fileType (integer) --

              The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects don't have a file name extension for a supported file or storage format.

            • storageClass (integer) --

              The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class.

            • total (integer) --

              The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class or don't have a file name extension for a supported file or storage format.

          • unclassifiableObjectSizeInBytes (dict) --

            The total storage size, in bytes, of the objects that Amazon Macie can't analyze in the bucket. These objects don't use a supported storage class or don't have a file name extension for a supported file or storage format.

            • fileType (integer) --

              The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects don't have a file name extension for a supported file or storage format.

            • storageClass (integer) --

              The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class.

            • total (integer) --

              The total storage size (in bytes) or number of objects that Amazon Macie can't analyze because the objects use an unsupported storage class or don't have a file name extension for a supported file or storage format.

    • NextToken (string) --

      A token to resume pagination.