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 |
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 |
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.