ControlTower / Client / list_control_operations

list_control_operations#

ControlTower.Client.list_control_operations(**kwargs)#

Provides a list of operations in progress or queued. For usage examples, see ListControlOperation examples.

See also: AWS API Documentation

Request Syntax

response = client.list_control_operations(
    filter={
        'controlIdentifiers': [
            'string',
        ],
        'controlOperationTypes': [
            'ENABLE_CONTROL'|'DISABLE_CONTROL'|'UPDATE_ENABLED_CONTROL',
        ],
        'enabledControlIdentifiers': [
            'string',
        ],
        'statuses': [
            'SUCCEEDED'|'FAILED'|'IN_PROGRESS',
        ],
        'targetIdentifiers': [
            'string',
        ]
    },
    maxResults=123,
    nextToken='string'
)
Parameters:
  • filter (dict) –

    An input filter for the ListControlOperations API that lets you select the types of control operations to view.

    • controlIdentifiers (list) –

      The set of controlIdentifier returned by the filter.

      • (string) –

    • controlOperationTypes (list) –

      The set of ControlOperation objects returned by the filter.

      • (string) –

    • enabledControlIdentifiers (list) –

      The set controlIdentifier of enabled controls selected by the filter.

      • (string) –

    • statuses (list) –

      Lists the status of control operations.

      • (string) –

    • targetIdentifiers (list) –

      The set of targetIdentifier objects returned by the filter.

      • (string) –

  • maxResults (integer) – The maximum number of results to be shown.

  • nextToken (string) – A pagination token.

Return type:

dict

Returns:

Response Syntax

{
    'controlOperations': [
        {
            'controlIdentifier': 'string',
            'enabledControlIdentifier': 'string',
            'endTime': datetime(2015, 1, 1),
            'operationIdentifier': 'string',
            'operationType': 'ENABLE_CONTROL'|'DISABLE_CONTROL'|'UPDATE_ENABLED_CONTROL',
            'startTime': datetime(2015, 1, 1),
            'status': 'SUCCEEDED'|'FAILED'|'IN_PROGRESS',
            'statusMessage': 'string',
            'targetIdentifier': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • controlOperations (list) –

      Returns a list of output from control operations.

      • (dict) –

        A summary of information about the specified control operation.

        • controlIdentifier (string) –

          The controlIdentifier of a control.

        • enabledControlIdentifier (string) –

          The controlIdentifier of an enabled control.

        • endTime (datetime) –

          The time at which the control operation was completed.

        • operationIdentifier (string) –

          The unique identifier of a control operation.

        • operationType (string) –

          The type of operation.

        • startTime (datetime) –

          The time at which a control operation began.

        • status (string) –

          The status of the specified control operation.

        • statusMessage (string) –

          A speficic message displayed as part of the control status.

        • targetIdentifier (string) –

          The unique identifier of the target of a control operation.

    • nextToken (string) –

      A pagination token.

Exceptions

  • ControlTower.Client.exceptions.ValidationException

  • ControlTower.Client.exceptions.InternalServerException

  • ControlTower.Client.exceptions.AccessDeniedException

  • ControlTower.Client.exceptions.ThrottlingException