list_timeline_events

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 using the following keys:

    • 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 to continue to the next page of results.
  • sortBy (string) -- Sort 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 time that the event occurred.

        • eventType (string) --

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

        • eventUpdatedTime (datetime) --

          The time that 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 continue to the next page of results.

Exceptions

  • SSMIncidents.Client.exceptions.ThrottlingException
  • SSMIncidents.Client.exceptions.AccessDeniedException
  • SSMIncidents.Client.exceptions.ValidationException
  • SSMIncidents.Client.exceptions.InternalServerException