SSM / Client / list_ops_item_events

list_ops_item_events#

SSM.Client.list_ops_item_events(**kwargs)#

Returns a list of all OpsItem events in the current Amazon Web Services Region and Amazon Web Services account. You can limit the results to events associated with specific OpsItems by specifying a filter.

See also: AWS API Documentation

Request Syntax

response = client.list_ops_item_events(
    Filters=[
        {
            'Key': 'OpsItemId',
            'Values': [
                'string',
            ],
            'Operator': 'Equal'
        },
    ],
    MaxResults=123,
    NextToken='string'
)
Parameters:
  • Filters (list) –

    One or more OpsItem filters. Use a filter to return a more specific list of results.

    • (dict) –

      Describes a filter for a specific list of OpsItem events. You can filter event information by using tags. You specify tags by using a key-value pair mapping.

      • Key (string) – [REQUIRED]

        The name of the filter key. Currently, the only supported value is OpsItemId.

      • Values (list) – [REQUIRED]

        The values for the filter, consisting of one or more OpsItem IDs.

        • (string) –

      • Operator (string) – [REQUIRED]

        The operator used by the filter call. Currently, the only supported value is Equal.

  • MaxResults (integer) – The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

  • NextToken (string) – A token to start the list. Use this token to get the next set of results.

Return type:

dict

Returns:

Response Syntax

{
    'NextToken': 'string',
    'Summaries': [
        {
            'OpsItemId': 'string',
            'EventId': 'string',
            'Source': 'string',
            'DetailType': 'string',
            'Detail': 'string',
            'CreatedBy': {
                'Arn': 'string'
            },
            'CreatedTime': datetime(2015, 1, 1)
        },
    ]
}

Response Structure

  • (dict) –

    • NextToken (string) –

      The token for the next set of items to return. Use this token to get the next set of results.

    • Summaries (list) –

      A list of event information for the specified OpsItems.

      • (dict) –

        Summary information about an OpsItem event or that associated an OpsItem with a related item.

        • OpsItemId (string) –

          The ID of the OpsItem.

        • EventId (string) –

          The ID of the OpsItem event.

        • Source (string) –

          The source of the OpsItem event.

        • DetailType (string) –

          The type of information provided as a detail.

        • Detail (string) –

          Specific information about the OpsItem event.

        • CreatedBy (dict) –

          Information about the user or resource that created the OpsItem event.

          • Arn (string) –

            The Amazon Resource Name (ARN) of the IAM entity that created the OpsItem event.

        • CreatedTime (datetime) –

          The date and time the OpsItem event was created.

Exceptions

  • SSM.Client.exceptions.InternalServerError

  • SSM.Client.exceptions.OpsItemNotFoundException

  • SSM.Client.exceptions.OpsItemLimitExceededException

  • SSM.Client.exceptions.OpsItemInvalidParameterException