durable_execution_histories

Creates, updates, deletes, gets or lists a durable_execution_histories resource.

Overview

Name	durable_execution_histories
Type	Resource
Id	aws.lambda.durable_execution_histories

Fields

The following fields are returned by SELECT queries:

get_durable_execution_history

Name	Datatype	Description
callback_failed_details	object	Contains details about a failed callback operation, including error information and the reason for failure.
callback_started_details	object	Contains details about a callback operation that has started, including timing information and callback metadata.
callback_succeeded_details	object	Contains details about a successfully completed callback operation, including the result data and completion timestamp.
callback_timed_out_details	object	Contains details about a callback operation that timed out, including timeout duration and any partial results.
chained_invoke_failed_details	object	Contains details about a failed chained function invocation, including error information and failure reason.
chained_invoke_started_details	object	Contains details about a chained function invocation that has started execution, including start time and execution context.
chained_invoke_stopped_details	object	Details about a chained invocation that was stopped.
chained_invoke_succeeded_details	object	Details about a chained invocation that succeeded.
chained_invoke_timed_out_details	object	Details about a chained invocation that timed out.
context_failed_details	object	Details about a context that failed.
context_started_details	object	Details about a context that started.
context_succeeded_details	object	Details about a context that succeeded.
event_id	integer	The unique identifier for this event. Event IDs increment sequentially.
event_timestamp	string (date-time)	The date and time when this event occurred, in ISO-8601 format (YYYY-MM-DDThh:mm:ss.sTZD).
event_type	string	The type of event that occurred. (ExecutionStarted, ExecutionSucceeded, ExecutionFailed, ExecutionTimedOut, ExecutionStopped, ContextStarted, ContextSucceeded, ContextFailed, WaitStarted, WaitSucceeded, WaitCancelled, StepStarted, StepSucceeded, StepFailed, ChainedInvokeStarted, ChainedInvokeSucceeded, ChainedInvokeFailed, ChainedInvokeTimedOut, ChainedInvokeStopped, CallbackStarted, CallbackSucceeded, CallbackFailed, CallbackTimedOut, InvocationCompleted)
execution_failed_details	object	Details about an execution that failed.
execution_started_details	object	Details about an execution that started.
execution_stopped_details	object	Details about an execution that was stopped.
execution_succeeded_details	object	Details about an execution that succeeded.
execution_timed_out_details	object	Details about an execution that timed out.
id	string	The unique identifier for this operation. (pattern: <code>[a-zA-Z0-9-_]+</code>)
invocation_completed_details	object	Details about a function invocation that completed.
name	string	The customer-provided name for this operation. (pattern: <code>[\x20-\x7E]+</code>)
parent_id	string	The unique identifier of the parent operation, if this operation is running within a child context. (pattern: <code>[a-zA-Z0-9-_]+</code>)
step_failed_details	object	Details about a step that failed.
step_started_details	object	Details about a step that started.
step_succeeded_details	object	Details about a step that succeeded.
sub_type	string	The subtype of the event, providing additional categorization. (pattern: <code>[a-zA-Z0-9-_]+</code>)
wait_cancelled_details	object	Details about a wait operation that was cancelled.
wait_started_details	object	Details about a wait operation that started.
wait_succeeded_details	object	Details about a wait operation that succeeded.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_durable_execution_history	select	durable_execution_arn, region	IncludeExecutionData, MaxItems, Marker, ReverseOrder	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

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
durable_execution_arn	string	The Amazon Resource Name (ARN) of the durable execution.
region	string	AWS region (default: us-east-1)
IncludeExecutionData	boolean	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	string	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.
MaxItems	integer	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.
ReverseOrder	boolean	When set to true, returns the history events in reverse chronological order (newest first). By default, events are returned in chronological order (oldest first).

SELECT examples

get_durable_execution_history

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.

SELECT
callback_failed_details,
callback_started_details,
callback_succeeded_details,
callback_timed_out_details,
chained_invoke_failed_details,
chained_invoke_started_details,
chained_invoke_stopped_details,
chained_invoke_succeeded_details,
chained_invoke_timed_out_details,
context_failed_details,
context_started_details,
context_succeeded_details,
event_id,
event_timestamp,
event_type,
execution_failed_details,
execution_started_details,
execution_stopped_details,
execution_succeeded_details,
execution_timed_out_details,
id,
invocation_completed_details,
name,
parent_id,
step_failed_details,
step_started_details,
step_succeeded_details,
sub_type,
wait_cancelled_details,
wait_started_details,
wait_succeeded_details
FROM aws.lambda.durable_execution_histories
WHERE durable_execution_arn = '{{ durable_execution_arn }}' -- required
AND region = '{{ region }}' -- required
AND IncludeExecutionData = '{{ IncludeExecutionData }}'
AND MaxItems = '{{ MaxItems }}'
AND Marker = '{{ Marker }}'
AND ReverseOrder = '{{ ReverseOrder }}'
;