Table Of Contents


User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . ecs ]




This action is only used by the Amazon EC2 Container Service agent, and it is not intended for use outside of the agent.

Sent to acknowledge that a task changed states.

See also: AWS API Documentation


[--cluster <value>]
[--task <value>]
[--status <value>]
[--reason <value>]
[--containers <value>]
[--attachments <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]


--cluster (string)

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

--task (string)

The task ID or full Amazon Resource Name (ARN) of the task in the state change request.

--status (string)

The status of the state change request.

--reason (string)

The reason for the state change request.

--containers (list)

Any containers associated with the state change request.

Shorthand Syntax:

containerName=string,exitCode=integer,networkBindings=[{bindIP=string,containerPort=integer,hostPort=integer,protocol=string},{bindIP=string,containerPort=integer,hostPort=integer,protocol=string}],reason=string,status=string ...

JSON Syntax:

    "containerName": "string",
    "exitCode": integer,
    "networkBindings": [
        "bindIP": "string",
        "containerPort": integer,
        "hostPort": integer,
        "protocol": "tcp"|"udp"
    "reason": "string",
    "status": "string"

--attachments (list)

Any attachments associated with the state change request.

Shorthand Syntax:

attachmentArn=string,status=string ...

JSON Syntax:

    "attachmentArn": "string",
    "status": "string"

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.


acknowledgment -> (string)

Acknowledgement of the state change.