SystemsManagerQuickSetup / Client / list_configurations

list_configurations

SystemsManagerQuickSetup.Client.list_configurations(**kwargs)

Returns configurations deployed by Quick Setup in the requesting Amazon Web Services account and Amazon Web Services Region.

See also: AWS API Documentation

Request Syntax

response = client.list_configurations(
    ConfigurationDefinitionId='string',
    Filters=[
        {
            'Key': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    ManagerArn='string',
    MaxItems=123,
    StartingToken='string'
)

Parameters:

• ConfigurationDefinitionId (string) – The ID of the configuration definition.

• Filters (list) –

  Filters the results returned by the request.

  • (dict) –

    A key-value pair to filter results.

    • Key (string) – [REQUIRED]

      The key for the filter.

    • Values (list) – [REQUIRED]

      The values for the filter keys.

      • (string) –

• ManagerArn (string) – The ARN of the configuration manager.

• MaxItems (integer) – Specifies the maximum number of configurations that are returned by the request.

• StartingToken (string) – The token to use when requesting a specific set of items from a list.

Return type:

dict

Returns:

Response Syntax

{
    'ConfigurationsList': [
        {
            'Account': 'string',
            'ConfigurationDefinitionId': 'string',
            'CreatedAt': datetime(2015, 1, 1),
            'FirstClassParameters': {
                'string': 'string'
            },
            'Id': 'string',
            'ManagerArn': 'string',
            'Region': 'string',
            'StatusSummaries': [
                {
                    'LastUpdatedAt': datetime(2015, 1, 1),
                    'Status': 'INITIALIZING'|'DEPLOYING'|'SUCCEEDED'|'DELETING'|'STOPPING'|'FAILED'|'STOPPED'|'DELETE_FAILED'|'STOP_FAILED'|'NONE',
                    'StatusDetails': {
                        'string': 'string'
                    },
                    'StatusMessage': 'string',
                    'StatusType': 'Deployment'|'AsyncExecutions'
                },
            ],
            'Type': 'string',
            'TypeVersion': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) –

  • ConfigurationsList (list) –

    An array of configurations.

    • (dict) –

      Details for a Quick Setup configuration.

      • Account (string) –

        The ID of the Amazon Web Services account where the configuration was deployed.

      • ConfigurationDefinitionId (string) –

        The ID of the configuration definition.

      • CreatedAt (datetime) –

        The datetime stamp when the configuration was created.

      • FirstClassParameters (dict) –

        The common parameters and values for the configuration definition.

        • (string) –

          • (string) –

      • Id (string) –

        A service generated identifier for the configuration.

      • ManagerArn (string) –

        The ARN of the configuration manager.

      • Region (string) –

        The Amazon Web Services Region where the configuration was deployed.

      • StatusSummaries (list) –

        A summary of the state of the configuration manager. This includes deployment statuses, association statuses, drift statuses, health checks, and more.

        • (dict) –

          A summarized description of the status.

          • LastUpdatedAt (datetime) –

            The datetime stamp when the status was last updated.

          • Status (string) –

            The current status.

          • StatusDetails (dict) –

            Details about the status.

            • (string) –

              • (string) –

          • StatusMessage (string) –

            When applicable, returns an informational message relevant to the current status and status type of the status summary object. We don’t recommend implementing parsing logic around this value since the messages returned can vary in format.

          • StatusType (string) –

            The type of a status summary.

      • Type (string) –

        The type of the Quick Setup configuration.

      • TypeVersion (string) –

        The version of the Quick Setup type used.

  • NextToken (string) –

    The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

Exceptions

• SystemsManagerQuickSetup.Client.exceptions.ValidationException

• SystemsManagerQuickSetup.Client.exceptions.InternalServerException

• SystemsManagerQuickSetup.Client.exceptions.AccessDeniedException

• SystemsManagerQuickSetup.Client.exceptions.ThrottlingException

• SystemsManagerQuickSetup.Client.exceptions.ResourceNotFoundException