Skip to content

get_durable_execution_state

Operation

get_durable_execution_state

get_durable_execution_state(request: GetDurableExecutionStateInput | GetDurableExecutionStateInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[GetDurableExecutionStateInputDict]) -> GetDurableExecutionStateOutput

Retrieves the current execution state required for the replay process during durable function execution. This API is used by the Lambda durable functions SDK to get state information needed for replay. You typically don't need to call this API directly as the SDK handles state management automatically.

The response contains operations ordered by start sequence number in ascending order. Completed operations with children don't include child operation details since they don't need to be replayed.

Parameters:

Name Type Description Default
request GetDurableExecutionStateInput | GetDurableExecutionStateInputDict | 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[GetDurableExecutionStateInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
GetDurableExecutionStateOutput

An instance of GetDurableExecutionStateOutput.

get_durable_execution_state async

get_durable_execution_state(request: GetDurableExecutionStateInput | GetDurableExecutionStateInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[GetDurableExecutionStateInputDict]) -> GetDurableExecutionStateOutput

Retrieves the current execution state required for the replay process during durable function execution. This API is used by the Lambda durable functions SDK to get state information needed for replay. You typically don't need to call this API directly as the SDK handles state management automatically.

The response contains operations ordered by start sequence number in ascending order. Completed operations with children don't include child operation details since they don't need to be replayed.

Parameters:

Name Type Description Default
request GetDurableExecutionStateInput | GetDurableExecutionStateInputDict | 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[GetDurableExecutionStateInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
GetDurableExecutionStateOutput

An instance of GetDurableExecutionStateOutput.

Input

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

GetDurableExecutionStateInputDict

Bases: TypedDict

Dictionary form of GetDurableExecutionStateInput.

Attributes

checkpoint_token instance-attribute
checkpoint_token: Required[str]

A checkpoint token that identifies the current state of the execution. This token is provided by the Lambda runtime and ensures that state retrieval is consistent with the current execution context.

durable_execution_arn instance-attribute
durable_execution_arn: Required[str]

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

marker instance-attribute
marker: str | None

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

max_items instance-attribute
max_items: int | None

The maximum number of operations 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.

GetDurableExecutionStateInput dataclass

Bases: _SerdeShape

Dataclass for GetDurableExecutionStateInput structure.

Attributes

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

A checkpoint token that identifies the current state of the execution. This token is provided by the Lambda runtime and ensures that state retrieval is consistent with the current execution context.

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

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

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 operations. Each pagination token expires after 24 hours.

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

The maximum number of operations 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.

Output

GetDurableExecutionStateOutput dataclass

Bases: _SerdeShape

The response from the GetDurableExecutionState operation, containing the current execution state for replay.

Attributes

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

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

operations instance-attribute
operations: list[Operation]

An array of operations that represent the current state of the durable execution. Operations are ordered by their start sequence number in ascending order and include information needed for replay processing.

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.