SSMIncidents / Client / list_timeline_events

list_timeline_events#

SSMIncidents.Client.list_timeline_events(**kwargs)#

Lists timeline events for the specified incident record.

See also: AWS API Documentation

Request Syntax

response = client.list_timeline_events(
    filters=[
        {
            'condition': {
                'after': datetime(2015, 1, 1),
                'before': datetime(2015, 1, 1),
                'equals': {
                    'integerValues': [
                        123,
                    ],
                    'stringValues': [
                        'string',
                    ]
                }
            },
            'key': 'string'
        },
    ],
    incidentRecordArn='string',
    maxResults=123,
    nextToken='string',
    sortBy='EVENT_TIME',
    sortOrder='ASCENDING'|'DESCENDING'
)
Parameters:
  • filters (list) –

    Filters the timeline events based on the provided conditional values. You can filter timeline events with the following keys:

    • eventReference

    • eventTime

    • eventType

    Note the following when deciding how to use Filters:

    • If you don’t specify a Filter, the response includes all timeline events.

    • If you specify more than one filter in a single request, the response returns timeline events that match all filters.

    • If you specify a filter with more than one value, the response returns timeline events that match any of the values provided.

    • (dict) –

      Filter the selection by using a condition.

      • condition (dict) – [REQUIRED]

        The condition accepts before or after a specified time, equal to a string, or equal to an integer.

        Note

        This is a Tagged Union structure. Only one of the following top level keys can be set: after, before, equals.

        • after (datetime) –

          After the specified timestamp.

        • before (datetime) –

          Before the specified timestamp

        • equals (dict) –

          The value is equal to the provided string or integer.

          Note

          This is a Tagged Union structure. Only one of the following top level keys can be set: integerValues, stringValues.

          • integerValues (list) –

            The list of integer values that the filter matches.

            • (integer) –

          • stringValues (list) –

            The list of string values that the filter matches.

            • (string) –

      • key (string) – [REQUIRED]

        The key that you’re filtering on.

  • incidentRecordArn (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the incident that includes the timeline event.

  • maxResults (integer) – The maximum number of results per page.

  • nextToken (string) – The pagination token for the next set of items to return. (You received this token from a previous call.)

  • sortBy (string) – Sort timeline events by the specified key value pair.

  • sortOrder (string) – Sorts the order of timeline events by the value specified in the sortBy field.

Return type:

dict

Returns:

Response Syntax

{
    'eventSummaries': [
        {
            'eventId': 'string',
            'eventReferences': [
                {
                    'relatedItemId': 'string',
                    'resource': 'string'
                },
            ],
            'eventTime': datetime(2015, 1, 1),
            'eventType': 'string',
            'eventUpdatedTime': datetime(2015, 1, 1),
            'incidentRecordArn': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • eventSummaries (list) –

      Details about each event that occurred during the incident.

      • (dict) –

        Details about a timeline event during an incident.

        • eventId (string) –

          The timeline event ID.

        • eventReferences (list) –

          A list of references in a TimelineEvent.

          • (dict) –

            An item referenced in a TimelineEvent that is involved in or somehow associated with an incident. You can specify an Amazon Resource Name (ARN) for an Amazon Web Services resource or a RelatedItem ID.

            Note

            This is a Tagged Union structure. Only one of the following top level keys will be set: relatedItemId, resource. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

            'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
            
            • relatedItemId (string) –

              The ID of a RelatedItem referenced in a TimelineEvent.

            • resource (string) –

              The Amazon Resource Name (ARN) of an Amazon Web Services resource referenced in a TimelineEvent.

        • eventTime (datetime) –

          The timestamp for when the event occurred.

        • eventType (string) –

          The type of event. The timeline event must be Custom Event or Note.

        • eventUpdatedTime (datetime) –

          The timestamp for when the timeline event was last updated.

        • incidentRecordArn (string) –

          The Amazon Resource Name (ARN) of the incident that the event happened during.

    • nextToken (string) –

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

Exceptions

  • SSMIncidents.Client.exceptions.ThrottlingException

  • SSMIncidents.Client.exceptions.AccessDeniedException

  • SSMIncidents.Client.exceptions.ValidationException

  • SSMIncidents.Client.exceptions.InternalServerException