Skip to content

Bedrock Agent Runtime  >  Operations  >  get_flow_execution

get_flow_execution

Operation

get_flow_execution async

get_flow_execution(input: GetFlowExecutionInput, plugins: list[Plugin] | None = None) -> GetFlowExecutionOutput

Retrieves details about a specific flow execution, including its status, start and end times, and any errors that occurred during execution.

Parameters:

Name Type Description Default
input GetFlowExecutionInput

An instance of GetFlowExecutionInput.

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
GetFlowExecutionOutput

An instance of GetFlowExecutionOutput.

Input

GetFlowExecutionInput dataclass

Dataclass for GetFlowExecutionInput structure.

Attributes

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

The unique identifier of the flow execution to retrieve.

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

The unique identifier of the flow alias used for the execution.

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

The unique identifier of the flow.

Output

GetFlowExecutionOutput dataclass

Dataclass for GetFlowExecutionOutput structure.

Attributes

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

The timestamp when the flow execution ended. This field is only populated when the execution has completed, failed, timed out, or been aborted.

errors class-attribute instance-attribute
errors: list[FlowExecutionError] | None = None

A list of errors that occurred during the flow execution. Each error includes an error code, message, and the node where the error occurred, if applicable.

execution_arn instance-attribute
execution_arn: str

The Amazon Resource Name (ARN) that uniquely identifies the flow execution.

flow_alias_identifier instance-attribute
flow_alias_identifier: str

The unique identifier of the flow alias used for the execution.

flow_identifier instance-attribute
flow_identifier: str

The unique identifier of the flow.

flow_version instance-attribute
flow_version: str

The version of the flow used for the execution.

started_at instance-attribute
started_at: datetime

The timestamp when the flow execution started.

status instance-attribute

The current status of the flow execution.

Flow executions time out after 24 hours.