AWS Control Tower

2026/11/17 - AWS Control Tower - 2 updated api methods

Changes  AWS Control Tower now reports source drift when an enabled baseline no longer matches the landing zone's configuration.

GetEnabledBaseline (updated) Link ¶
Changes (response)
{'enabledBaselineDetails': {'driftStatusSummary': {'types': {'source': {'status': 'IN_SYNC '
                                                                                  '| '
                                                                                  'DRIFTED'}}}}}

Retrieve details of an EnabledBaseline resource by specifying its identifier.

See also: AWS API Documentation

Request Syntax

client.get_enabled_baseline(
    enabledBaselineIdentifier='string'
)
type enabledBaselineIdentifier:

string

param enabledBaselineIdentifier:

[REQUIRED]

Identifier of the EnabledBaseline resource to be retrieved, in ARN format.

rtype:

dict

returns:

Response Syntax

{
    'enabledBaselineDetails': {
        'arn': 'string',
        'baselineIdentifier': 'string',
        'baselineVersion': 'string',
        'driftStatusSummary': {
            'types': {
                'inheritance': {
                    'status': 'IN_SYNC'|'DRIFTED'
                },
                'source': {
                    'status': 'IN_SYNC'|'DRIFTED'
                }
            }
        },
        'targetIdentifier': 'string',
        'parentIdentifier': 'string',
        'statusSummary': {
            'status': 'SUCCEEDED'|'FAILED'|'UNDER_CHANGE',
            'lastOperationIdentifier': 'string'
        },
        'parameters': [
            {
                'key': 'string',
                'value': {...}|[...]|123|123.4|'string'|True|None
            },
        ]
    }
}

Response Structure

  • (dict) --

    • enabledBaselineDetails (dict) --

      Details of the EnabledBaseline resource.

      • arn (string) --

        The ARN of the EnabledBaseline resource.

      • baselineIdentifier (string) --

        The specific Baseline enabled as part of the EnabledBaseline resource.

      • baselineVersion (string) --

        The enabled version of the Baseline.

      • driftStatusSummary (dict) --

        The drift status of the enabled baseline.

        • types (dict) --

          The types of drift that can be detected for an enabled baseline. Amazon Web Services Control Tower detects inheritance drift on enabled baselines that apply at the OU level.

          • inheritance (dict) --

            At least one account within the target OU does not match the baseline configuration defined on that OU. An account is in inheritance drift when it does not match the configuration of a parent OU, possibly a new parent OU, if the account is moved.

            • status (string) --

              The inheritance drift status for enabled baselines.

          • source (dict) --

            Source drift occurs when an enabled baseline no longer matches the landing zone's configuration.

            • status (string) --

              The source drift status for the enabled baseline.

      • targetIdentifier (string) --

        The target on which to enable the Baseline.

      • parentIdentifier (string) --

        An ARN that represents the parent EnabledBaseline at the Organizational Unit (OU) level, from which the child EnabledBaseline inherits its configuration. The value is returned by GetEnabledBaseline.

      • statusSummary (dict) --

        The deployment summary of an EnabledControl or EnabledBaseline resource.

        • status (string) --

          The deployment status of the enabled resource.

          Valid values:

          • SUCCEEDED: The EnabledControl or EnabledBaseline configuration was deployed successfully.

          • UNDER_CHANGE: The EnabledControl or EnabledBaseline configuration is changing.

          • FAILED: The EnabledControl or EnabledBaseline configuration failed to deploy.

        • lastOperationIdentifier (string) --

          The last operation identifier for the enabled resource.

      • parameters (list) --

        Shows the parameters that are applied when enabling this Baseline.

        • (dict) --

          Summary of an applied parameter to an EnabledBaseline resource.

          • key (string) --

            A string denoting the parameter key.

          • value (:ref:`document<document>`) --

            A low-level document object of any type (for example, a Java Object).

ListEnabledBaselines (updated) Link ¶
Changes (request, response)
Request
{'filter': {'sourceDriftStatuses': ['IN_SYNC | DRIFTED']}}
Response
{'enabledBaselines': {'driftStatusSummary': {'types': {'source': {'status': 'IN_SYNC '
                                                                            '| '
                                                                            'DRIFTED'}}}}}

Returns a list of summaries describing EnabledBaseline resources. You can filter the list by the corresponding Baseline or Target of the EnabledBaseline resources. For usage examples, see the Amazon Web Services Control Tower User Guide.

See also: AWS API Documentation

Request Syntax

client.list_enabled_baselines(
    filter={
        'targetIdentifiers': [
            'string',
        ],
        'baselineIdentifiers': [
            'string',
        ],
        'parentIdentifiers': [
            'string',
        ],
        'statuses': [
            'SUCCEEDED'|'FAILED'|'UNDER_CHANGE',
        ],
        'inheritanceDriftStatuses': [
            'IN_SYNC'|'DRIFTED',
        ],
        'sourceDriftStatuses': [
            'IN_SYNC'|'DRIFTED',
        ]
    },
    nextToken='string',
    maxResults=123,
    includeChildren=True|False
)
type filter:

dict

param filter:

A filter applied on the ListEnabledBaseline operation. Allowed filters are baselineIdentifiers and targetIdentifiers. The filter can be applied for either, or both.

  • targetIdentifiers (list) --

    Identifiers for the targets of the Baseline filter operation.

    • (string) --

  • baselineIdentifiers (list) --

    Identifiers for the Baseline objects returned as part of the filter operation.

    • (string) --

  • parentIdentifiers (list) --

    An optional filter that sets up a list of parentIdentifiers to filter the results of the ListEnabledBaseline output.

    • (string) --

  • statuses (list) --

    A list of EnablementStatus items.

    • (string) --

  • inheritanceDriftStatuses (list) --

    A list of EnabledBaselineDriftStatus items for enabled baselines.

    • (string) --

  • sourceDriftStatuses (list) --

    A list of EnabledBaselineDriftStatus items for enabled baselines.

    • (string) --

type nextToken:

string

param nextToken:

A pagination token.

type maxResults:

integer

param maxResults:

The maximum number of results to be shown.

type includeChildren:

boolean

param includeChildren:

A value that can be set to include the child enabled baselines in responses. The default value is false.

rtype:

dict

returns:

Response Syntax

{
    'enabledBaselines': [
        {
            'arn': 'string',
            'baselineIdentifier': 'string',
            'baselineVersion': 'string',
            'driftStatusSummary': {
                'types': {
                    'inheritance': {
                        'status': 'IN_SYNC'|'DRIFTED'
                    },
                    'source': {
                        'status': 'IN_SYNC'|'DRIFTED'
                    }
                }
            },
            'targetIdentifier': 'string',
            'parentIdentifier': 'string',
            'statusSummary': {
                'status': 'SUCCEEDED'|'FAILED'|'UNDER_CHANGE',
                'lastOperationIdentifier': 'string'
            }
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • enabledBaselines (list) --

      Retuens a list of summaries of EnabledBaseline resources.

      • (dict) --

        Returns a summary of information about an EnabledBaseline object.

        • arn (string) --

          The ARN of the EnabledBaseline resource

        • baselineIdentifier (string) --

          The specific baseline that is enabled as part of the EnabledBaseline resource.

        • baselineVersion (string) --

          The enabled version of the baseline.

        • driftStatusSummary (dict) --

          The drift status of the enabled baseline.

          • types (dict) --

            The types of drift that can be detected for an enabled baseline. Amazon Web Services Control Tower detects inheritance drift on enabled baselines that apply at the OU level.

            • inheritance (dict) --

              At least one account within the target OU does not match the baseline configuration defined on that OU. An account is in inheritance drift when it does not match the configuration of a parent OU, possibly a new parent OU, if the account is moved.

              • status (string) --

                The inheritance drift status for enabled baselines.

            • source (dict) --

              Source drift occurs when an enabled baseline no longer matches the landing zone's configuration.

              • status (string) --

                The source drift status for the enabled baseline.

        • targetIdentifier (string) --

          The target upon which the baseline is enabled.

        • parentIdentifier (string) --

          An ARN that represents an object returned by ListEnabledBaseline, to describe an enabled baseline.

        • statusSummary (dict) --

          The deployment summary of an EnabledControl or EnabledBaseline resource.

          • status (string) --

            The deployment status of the enabled resource.

            Valid values:

            • SUCCEEDED: The EnabledControl or EnabledBaseline configuration was deployed successfully.

            • UNDER_CHANGE: The EnabledControl or EnabledBaseline configuration is changing.

            • FAILED: The EnabledControl or EnabledBaseline configuration failed to deploy.

          • lastOperationIdentifier (string) --

            The last operation identifier for the enabled resource.

    • nextToken (string) --

      A pagination token.