AccessAnalyzer / Client / update_analyzer

update_analyzer#

AccessAnalyzer.Client.update_analyzer(**kwargs)#

Modifies the configuration of an existing analyzer.

See also: AWS API Documentation

Request Syntax

response = client.update_analyzer(
    analyzerName='string',
    configuration={
        'unusedAccess': {
            'unusedAccessAge': 123,
            'analysisRule': {
                'exclusions': [
                    {
                        'accountIds': [
                            'string',
                        ],
                        'resourceTags': [
                            {
                                'string': 'string'
                            },
                        ]
                    },
                ]
            }
        }
    }
)
Parameters:

  • analyzerName (string) –

    [REQUIRED]

    The name of the analyzer to modify.

  • configuration (dict) –

    Contains information about the configuration of an analyzer for an Amazon Web Services organization or account.

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: unusedAccess.

    • unusedAccess (dict) –

      Specifies the configuration of an unused access analyzer for an Amazon Web Services organization or account.

      • unusedAccessAge (integer) –

        The specified access age in days for which to generate findings for unused access. For example, if you specify 90 days, the analyzer will generate findings for IAM entities within the accounts of the selected organization for any access that hasn’t been used in 90 or more days since the analyzer’s last scan. You can choose a value between 1 and 365 days.

      • analysisRule (dict) –

        Contains information about analysis rules for the analyzer. Analysis rules determine which entities will generate findings based on the criteria you define when you create the rule.

        • exclusions (list) –

          A list of rules for the analyzer containing criteria to exclude from analysis. Entities that meet the rule criteria will not generate findings.

          • (dict) –

            The criteria for an analysis rule for an analyzer. The criteria determine which entities will generate findings.

            • accountIds (list) –

              A list of Amazon Web Services account IDs to apply to the analysis rule criteria. The accounts cannot include the organization analyzer owner account. Account IDs can only be applied to the analysis rule criteria for organization-level analyzers. The list cannot include more than 2,000 account IDs.

              • (string) –

            • resourceTags (list) –

              An array of key-value pairs to match for your resources. You can use the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.

              For the tag key, you can specify a value that is 1 to 128 characters in length and cannot be prefixed with aws:.

              For the tag value, you can specify a value that is 0 to 256 characters in length. If the specified tag value is 0 characters, the rule is applied to all principals with the specified tag key.

              • (dict) –

                • (string) –

                  • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'configuration': {
        'unusedAccess': {
            'unusedAccessAge': 123,
            'analysisRule': {
                'exclusions': [
                    {
                        'accountIds': [
                            'string',
                        ],
                        'resourceTags': [
                            {
                                'string': 'string'
                            },
                        ]
                    },
                ]
            }
        }
    }
}

Response Structure

  • (dict) –

    • configuration (dict) –

      Contains information about the configuration of an analyzer for an Amazon Web Services organization or account.

      Note

      This is a Tagged Union structure. Only one of the following top level keys will be set: unusedAccess. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

      'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}

      • unusedAccess (dict) –

        Specifies the configuration of an unused access analyzer for an Amazon Web Services organization or account.

        • unusedAccessAge (integer) –

          The specified access age in days for which to generate findings for unused access. For example, if you specify 90 days, the analyzer will generate findings for IAM entities within the accounts of the selected organization for any access that hasn’t been used in 90 or more days since the analyzer’s last scan. You can choose a value between 1 and 365 days.

        • analysisRule (dict) –

          Contains information about analysis rules for the analyzer. Analysis rules determine which entities will generate findings based on the criteria you define when you create the rule.

          • exclusions (list) –

            A list of rules for the analyzer containing criteria to exclude from analysis. Entities that meet the rule criteria will not generate findings.

            • (dict) –

              The criteria for an analysis rule for an analyzer. The criteria determine which entities will generate findings.

              • accountIds (list) –

                A list of Amazon Web Services account IDs to apply to the analysis rule criteria. The accounts cannot include the organization analyzer owner account. Account IDs can only be applied to the analysis rule criteria for organization-level analyzers. The list cannot include more than 2,000 account IDs.

                • (string) –

              • resourceTags (list) –

                An array of key-value pairs to match for your resources. You can use the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.

                For the tag key, you can specify a value that is 1 to 128 characters in length and cannot be prefixed with aws:.

                For the tag value, you can specify a value that is 0 to 256 characters in length. If the specified tag value is 0 characters, the rule is applied to all principals with the specified tag key.

                • (dict) –

                  • (string) –

                    • (string) –

Exceptions