create_analyzer

create_analyzer(**kwargs)

Creates an analyzer for your account.

See also: AWS API Documentation

Request Syntax

response = client.create_analyzer(
    analyzerName='string',
    type='ACCOUNT'|'ORGANIZATION',
    archiveRules=[
        {
            'ruleName': 'string',
            'filter': {
                'string': {
                    'eq': [
                        'string',
                    ],
                    'neq': [
                        'string',
                    ],
                    'contains': [
                        'string',
                    ],
                    'exists': True|False
                }
            }
        },
    ],
    tags={
        'string': 'string'
    },
    clientToken='string'
)

Parameters

• analyzerName (string) --

  [REQUIRED]

  The name of the analyzer to create.

• type (string) --

  [REQUIRED]

  The type of analyzer to create. Only ACCOUNT and ORGANIZATION analyzers are supported. You can create only one analyzer per account per Region. You can create up to 5 analyzers per organization per Region.

• archiveRules (list) --

  Specifies the archive rules to add for the analyzer. Archive rules automatically archive findings that meet the criteria you define for the rule.

  • (dict) --

    An criterion statement in an archive rule. Each archive rule may have multiple criteria.

    • ruleName (string) -- [REQUIRED]

      The name of the rule.

    • filter (dict) -- [REQUIRED]

      The condition and values for a criterion.

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

          The criteria to use in the filter that defines the archive rule. For more information on available filter keys, see IAM Access Analyzer filter keys.

          • eq (list) --

            An "equals" operator to match for the filter used to create the rule.

            • (string) --
          • neq (list) --

            A "not equals" operator to match for the filter used to create the rule.

            • (string) --
          • contains (list) --

            A "contains" operator to match for the filter used to create the rule.

            • (string) --
          • exists (boolean) --

            An "exists" operator to match for the filter used to create the rule.

• tags (dict) --

  The tags to apply to the analyzer.

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

  A client token.

  This field is autopopulated if not provided.

Return type

dict

Returns

Response Syntax

{
    'arn': 'string'
}

Response Structure

• (dict) --

  The response to the request to create an analyzer.

  • arn (string) --

    The ARN of the analyzer that was created by the request.

Exceptions

• AccessAnalyzer.Client.exceptions.ConflictException
• AccessAnalyzer.Client.exceptions.ValidationException
• AccessAnalyzer.Client.exceptions.InternalServerException
• AccessAnalyzer.Client.exceptions.ServiceQuotaExceededException
• AccessAnalyzer.Client.exceptions.ThrottlingException
• AccessAnalyzer.Client.exceptions.AccessDeniedException