ControlCatalog / Client / list_common_controls

list_common_controls#

ControlCatalog.Client.list_common_controls(**kwargs)#

Returns a paginated list of common controls from the Amazon Web Services Control Catalog.

You can apply an optional filter to see common controls that have a specific objective. If you don’t provide a filter, the operation returns all common controls.

See also: AWS API Documentation

Request Syntax

response = client.list_common_controls(
    CommonControlFilter={
        'Objectives': [
            {
                'Arn': 'string'
            },
        ]
    },
    MaxResults=123,
    NextToken='string'
)
Parameters:

  • CommonControlFilter (dict) –

    An optional filter that narrows the results to a specific objective.

    This filter allows you to specify one objective ARN at a time. Passing multiple ARNs in the CommonControlFilter isn’t currently supported.

    • Objectives (list) –

      The objective that’s used as filter criteria.

      You can use this parameter to specify one objective ARN at a time. Passing multiple ARNs in the CommonControlFilter isn’t currently supported.

      • (dict) –

        The objective resource that’s being used as a filter.

        • Arn (string) –

          The Amazon Resource Name (ARN) of the objective.

  • MaxResults (integer) – The maximum number of results on a page or for an API request call.

  • NextToken (string) – The pagination token that’s used to fetch the next set of results.

Return type:

dict

Returns:

Response Syntax

{
    'CommonControls': [
        {
            'Arn': 'string',
            'CreateTime': datetime(2015, 1, 1),
            'Description': 'string',
            'Domain': {
                'Arn': 'string',
                'Name': 'string'
            },
            'LastUpdateTime': datetime(2015, 1, 1),
            'Name': 'string',
            'Objective': {
                'Arn': 'string',
                'Name': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • CommonControls (list) –

      The list of common controls that the ListCommonControls API returns.

      • (dict) –

        A summary of metadata for a common control.

        • Arn (string) –

          The Amazon Resource Name (ARN) that identifies the common control.

        • CreateTime (datetime) –

          The time when the common control was created.

        • Description (string) –

          The description of the common control.

        • Domain (dict) –

          The domain that the common control belongs to.

          • Arn (string) –

            The Amazon Resource Name (ARN) of the related domain.

          • Name (string) –

            The name of the related domain.

        • LastUpdateTime (datetime) –

          The time when the common control was most recently updated.

        • Name (string) –

          The name of the common control.

        • Objective (dict) –

          The objective that the common control belongs to.

          • Arn (string) –

            The Amazon Resource Name (ARN) of the related objective.

          • Name (string) –

            The name of the related objective.

    • NextToken (string) –

      The pagination token that’s used to fetch the next set of results.

Exceptions