Skip to content

get_durable_execution_history

Operation

get_durable_execution_history

get_durable_execution_history(request: GetDurableExecutionHistoryInput | GetDurableExecutionHistoryInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[GetDurableExecutionHistoryInputDict]) -> GetDurableExecutionHistoryOutput

Retrieves the execution history for a durable execution, showing all the steps, callbacks, and events that occurred during the execution. This provides a detailed audit trail of the execution's progress over time.

The history is available while the execution is running and for a retention period after it completes (1-90 days, default 30 days). You can control whether to include execution data such as step results and callback payloads.

Parameters:

Name Type Description Default
request GetDurableExecutionHistoryInput | GetDurableExecutionHistoryInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[GetDurableExecutionHistoryInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
GetDurableExecutionHistoryOutput

An instance of GetDurableExecutionHistoryOutput.

get_durable_execution_history async

get_durable_execution_history(request: GetDurableExecutionHistoryInput | GetDurableExecutionHistoryInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[GetDurableExecutionHistoryInputDict]) -> GetDurableExecutionHistoryOutput

Retrieves the execution history for a durable execution, showing all the steps, callbacks, and events that occurred during the execution. This provides a detailed audit trail of the execution's progress over time.

The history is available while the execution is running and for a retention period after it completes (1-90 days, default 30 days). You can control whether to include execution data such as step results and callback payloads.

Parameters:

Name Type Description Default
request GetDurableExecutionHistoryInput | GetDurableExecutionHistoryInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[GetDurableExecutionHistoryInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
GetDurableExecutionHistoryOutput

An instance of GetDurableExecutionHistoryOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

GetDurableExecutionHistoryInputDict

Bases: TypedDict

Dictionary form of GetDurableExecutionHistoryInput.

Attributes

durable_execution_arn instance-attribute
durable_execution_arn: Required[str]

The Amazon Resource Name (ARN) of the durable execution.

include_execution_data instance-attribute
include_execution_data: bool | None

Specifies whether to include execution data such as step results and callback payloads in the history events. Set to true to include data, or false to exclude it for a more compact response. The default is true.

marker instance-attribute
marker: str | None

If NextMarker was returned from a previous request, use this value to retrieve the next page of results. Each pagination token expires after 24 hours.

max_items instance-attribute
max_items: int | None

The maximum number of history events to return per call. You can use Marker to retrieve additional pages of results. The default is 100 and the maximum allowed is 1000. A value of 0 uses the default.

reverse_order instance-attribute
reverse_order: bool | None

When set to true, returns the history events in reverse chronological order (newest first). By default, events are returned in chronological order (oldest first).

GetDurableExecutionHistoryInput dataclass

Bases: _SerdeShape

Dataclass for GetDurableExecutionHistoryInput structure.

Attributes

durable_execution_arn class-attribute instance-attribute
durable_execution_arn: str | None = ...

The Amazon Resource Name (ARN) of the durable execution.

include_execution_data class-attribute instance-attribute
include_execution_data: bool | None = ...

Specifies whether to include execution data such as step results and callback payloads in the history events. Set to true to include data, or false to exclude it for a more compact response. The default is true.

marker class-attribute instance-attribute
marker: str | None = ...

If NextMarker was returned from a previous request, use this value to retrieve the next page of results. Each pagination token expires after 24 hours.

max_items class-attribute instance-attribute
max_items: int = ...

The maximum number of history events to return per call. You can use Marker to retrieve additional pages of results. The default is 100 and the maximum allowed is 1000. A value of 0 uses the default.

reverse_order class-attribute instance-attribute
reverse_order: bool | None = ...

When set to true, returns the history events in reverse chronological order (newest first). By default, events are returned in chronological order (oldest first).

Output

GetDurableExecutionHistoryOutput dataclass

Bases: _SerdeShape

The response from the GetDurableExecutionHistory operation, containing the execution history and events.

Attributes

events instance-attribute
events: list[Event]

An array of execution history events, ordered chronologically unless ReverseOrder is set to true. Each event represents a significant occurrence during the execution, such as step completion or callback resolution.

next_marker class-attribute instance-attribute
next_marker: str | None = ...

If present, indicates that more history events are available. Use this value as the Marker parameter in a subsequent request to retrieve the next page of results.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.