SSMIncidents / Client / get_timeline_event

get_timeline_event#

SSMIncidents.Client.get_timeline_event(**kwargs)#

Retrieves a timeline event based on its ID and incident record.

See also: AWS API Documentation

Request Syntax

response = client.get_timeline_event(
    eventId='string',
    incidentRecordArn='string'
)
Parameters:
  • eventId (string) –

    [REQUIRED]

    The ID of the event. You can get an event’s ID when you create it, or by using ListTimelineEvents.

  • incidentRecordArn (string) –

    [REQUIRED]

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

Return type:

dict

Returns:

Response Syntax

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

Response Structure

  • (dict) –

    • event (dict) –

      Details about the timeline event.

      • eventData (string) –

        A short description of the event.

      • eventId (string) –

        The ID of the timeline event.

      • 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 that occurred. Currently Incident Manager supports only the Custom Event type.

      • eventUpdatedTime (datetime) –

        The time that the timeline event was last updated.

      • incidentRecordArn (string) –

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

Exceptions

  • SSMIncidents.Client.exceptions.ThrottlingException

  • SSMIncidents.Client.exceptions.ResourceNotFoundException

  • SSMIncidents.Client.exceptions.AccessDeniedException

  • SSMIncidents.Client.exceptions.ValidationException

  • SSMIncidents.Client.exceptions.InternalServerException