Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14159484.0 KB

Retrieves detailed information about a specific task instance within a workflow run. Task instances represent individual tasks that are executed as part of a workflow in the Amazon Managed Workflows for Apache Airflow Serverless environment. Each task instance runs in an isolated ECS container with dedicated resources and security boundaries. The service tracks task execution state, retry attempts, and provides detailed timing and error information for troubleshooting and monitoring purposes.

post/#X-Amz-Target=AmazonMWAAServerless.GetTaskInstance

Headers

X-Amz-Target'AmazonMWAAServerless.GetTaskInstance' required

Request body

WorkflowArnstring required

The Amazon Resource Name (ARN) of the workflow that contains the task instance.

TaskInstanceIdstring required

The unique identifier of the task instance to retrieve.

RunIdstring required

The unique identifier of the workflow run that contains the task instance.

Response

Success

WorkflowArnstring required

The Amazon Resource Name (ARN) of the workflow that contains this task instance.

RunIdstring required

The unique identifier of the workflow run that contains this task instance.

TaskInstanceIdstring required

The unique identifier of this task instance.

WorkflowVersionstring

The version of the workflow that contains this task instance.

Status'QUEUED' | 'FAILED' | 'SCHEDULED' | 'RUNNING' | 'SUCCESS' | 'UP_FOR_RESCHEDULE' | 'UP_FOR_RETRY' | 'UPSTREAM_FAILED' | 'REMOVED' | 'RESTARTING' | 'DEFERRED' | 'NONE' | 'CANCELLED' | 'TIMEOUT'

The current status of the task instance.

DurationInSecondsinteger

The duration of the task instance execution in seconds. This value is null if the task is not complete.

OperatorNamestring

The name of the Apache Airflow operator used for this task instance.

ModifiedAtstring date-time

The timestamp when the task instance was last modified, in ISO 8601 date-time format.

EndedAtstring date-time

The timestamp when the task instance completed execution, in ISO 8601 date-time format. This value is null if the task is not complete.

StartedAtstring date-time

The timestamp when the task instance started execution, in ISO 8601 date-time format. This value is null if the task has not started.

AttemptNumberinteger

The attempt number for this task instance.

ErrorMessagestring

The error message if the task instance failed. This value is null if the task completed successfully.

TaskIdstring

The unique identifier of the task definition within the workflow.

LogStreamstring

The CloudWatch log stream name for this task instance execution.

Xcomobject

Cross-communication data exchanged between tasks in the workflow execution.