Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1456373564.1 KB

<note> <p>This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.</p> </note> <p>Sent to acknowledge that a task changed states.</p>

post/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.SubmitTaskStateChange

Headers

X-Amz-Target'AmazonEC2ContainerServiceV20141113.SubmitTaskStateChange' required

Request body

clusterstring

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the task.

taskstring

The task ID or full ARN of the task in the state change request.

statusstring

The status of the state change request.

reasonstring

The reason for the state change request.

pullStartedAtstring date-time

The Unix timestamp for the time when the container image pull started.

pullStoppedAtstring date-time

The Unix timestamp for the time when the container image pull completed.

executionStoppedAtstring date-time

The Unix timestamp for the time when the task execution stopped.

Response

Success

acknowledgmentstring

Acknowledgement of the state change.