Skip to content

Lambda  >  Operations  >  list_durable_executions_by_function

list_durable_executions_by_function

Operation

list_durable_executions_by_function async

list_durable_executions_by_function(input: ListDurableExecutionsByFunctionInput, plugins: list[Plugin] | None = None) -> ListDurableExecutionsByFunctionOutput

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:

Name Type Description Default
input ListDurableExecutionsByFunctionInput

An instance of ListDurableExecutionsByFunctionInput.

required
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

Returns:

Type Description
ListDurableExecutionsByFunctionOutput

An instance of ListDurableExecutionsByFunctionOutput.

Input

ListDurableExecutionsByFunctionInput dataclass

Dataclass for ListDurableExecutionsByFunctionInput structure.

Attributes

durable_execution_name class-attribute instance-attribute
durable_execution_name: str | None = None

Filter executions by name. Only executions with names that matches this string are returned.

function_name class-attribute instance-attribute
function_name: str | None = None

The name or ARN of the Lambda function. You can specify a function name, a partial ARN, or a full ARN.

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

Pagination token from a previous request to continue retrieving results.

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

Maximum number of executions to return (1-1000). Default is 100.

qualifier class-attribute instance-attribute
qualifier: str | None = None

The function version or alias. If not specified, lists executions for the $LATEST version.

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

Set to true to return results in chronological order (oldest first). Default is false.

started_after class-attribute instance-attribute
started_after: datetime | None = None

Filter executions that started after this timestamp (ISO 8601 format).

started_before class-attribute instance-attribute
started_before: datetime | None = None

Filter executions that started before this timestamp (ISO 8601 format).

statuses class-attribute instance-attribute
statuses: list[ExecutionStatus] | None = None

Filter executions by status. Valid values: RUNNING, SUCCEEDED, FAILED, TIMED_OUT, STOPPED.

Output

ListDurableExecutionsByFunctionOutput dataclass

The response from the ListDurableExecutionsByFunction operation, containing a list of durable executions and pagination information.

Attributes

durable_executions class-attribute instance-attribute
durable_executions: list[Execution] | None = None

List of durable execution summaries matching the filter criteria.

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

Pagination token for retrieving additional results. Present only if there are more results available.