durable_executions_by_functions

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

Overview

Name	durable_executions_by_functions
Type	Resource
Id	aws.lambda.durable_executions_by_functions

Fields

The following fields are returned by SELECT queries:

list_durable_executions_by_function

Name	Datatype	Description
durable_execution_arn	string	The Amazon Resource Name (ARN) of the durable execution, if this execution is a durable execution. (pattern: <code>arn:([a-zA-Z0-9-]+):lambda:([a-zA-Z0-9-]+):(\d{12}):function:([a-zA-Z0-9_-]+):($LATEST(?:.PUBLISHED)?|[0-9]+)/durable-execution/([a-zA-Z0-9_-]+)/([a-zA-Z0-9_-]+)</code>)
durable_execution_name	string	The unique name of the durable execution, if one was provided when the execution was started. (pattern: <code>[a-zA-Z0-9-_]+</code>)
end_timestamp	string (date-time)	The date and time when the durable execution ended, in ISO-8601 format (YYYY-MM-DDThh:mm:ss.sTZD).
function_arn	string	The Amazon Resource Name (ARN) of the Lambda function. (pattern: <code>arn:(aws[a-zA-Z-]*)?:lambda:(eusc-)?[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-.]+(:($LATEST(.PUBLISHED)?|[a-zA-Z0-9-]+))?</code>)
kms_key_arn	string	The ARN of the Key Management Service (KMS) customer managed key that is used to encrypt your durable execution's payload data, including input, output, and error payloads. (pattern: <code>(arn:(aws[a-zA-Z-])?:[a-z0-9-.]+:.)|()</code>)
start_timestamp	string (date-time)	The date and time when the durable execution started, in ISO-8601 format (YYYY-MM-DDThh:mm:ss.sTZD).
status	string	The current status of the durable execution. (RUNNING, SUCCEEDED, FAILED, TIMED_OUT, STOPPED)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_durable_executions_by_function	select	function_name, region	Qualifier, DurableExecutionName, Statuses, StartedAfter, StartedBefore, ReverseOrder, Marker, MaxItems	Returns a list of durable executions for a specified Lambda function. You can filter the results by execution name, status, and start time range. This API supports pagination for large result sets.

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
function_name	string	The name or ARN of the Lambda function. You can specify a function name, a partial ARN, or a full ARN.
region	string	AWS region (default: us-east-1)
DurableExecutionName	string	Filter executions by name. Only executions with names that matches this string are returned.
Marker	string	Pagination token from a previous request to continue retrieving results.
MaxItems	integer	Maximum number of executions to return (1-1000). Default is 100.
Qualifier	string	The function version or alias. If not specified, lists executions for the $LATEST version.
ReverseOrder	boolean	Set to true to return results in chronological order (oldest first). Default is false.
StartedAfter	string (date-time)	Filter executions that started after this timestamp (ISO 8601 format).
StartedBefore	string (date-time)	Filter executions that started before this timestamp (ISO 8601 format).
Statuses	array	Filter executions by status. Valid values: RUNNING, SUCCEEDED, FAILED, TIMED_OUT, STOPPED.

SELECT examples

list_durable_executions_by_function

Returns a list of durable executions for a specified Lambda function. You can filter the results by execution name, status, and start time range. This API supports pagination for large result sets.

SELECT
durable_execution_arn,
durable_execution_name,
end_timestamp,
function_arn,
kms_key_arn,
start_timestamp,
status
FROM aws.lambda.durable_executions_by_functions
WHERE function_name = '{{ function_name }}' -- required
AND region = '{{ region }}' -- required
AND Qualifier = '{{ Qualifier }}'
AND DurableExecutionName = '{{ DurableExecutionName }}'
AND Statuses = '{{ Statuses }}'
AND StartedAfter = '{{ StartedAfter }}'
AND StartedBefore = '{{ StartedBefore }}'
AND ReverseOrder = '{{ ReverseOrder }}'
AND Marker = '{{ Marker }}'
AND MaxItems = '{{ MaxItems }}'
;