v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1456373564.1 KB

Create a task set in the specified cluster and service. This is used when a service uses the <code>EXTERNAL</code> deployment controller type. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html">Amazon ECS deployment types</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.

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

Headers

X-Amz-Target'AmazonEC2ContainerServiceV20141113.CreateTaskSet' required

Request body

servicestring required

The short name or full Amazon Resource Name (ARN) of the service to create the task set in.

clusterstring required

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the service to create the task set in.

externalIdstring

An optional non-unique tag that identifies this task set in external systems. If the task set is associated with a service discovery registry, the tasks in this task set will have the <code>ECS_TASK_SET_EXTERNAL_ID</code> Cloud Map attribute set to the provided value.

taskDefinitionstring required

The task definition for the tasks in the task set to use.

launchType'EC2' | 'FARGATE' | 'EXTERNAL'
<p>The launch type that new tasks in the task set uses. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html">Amazon ECS launch types</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p> <p>If a <code>launchType</code> is specified, the <code>capacityProviderStrategy</code> parameter must be omitted.</p>
platformVersionstring

The platform version that the tasks in the task set uses. A platform version is specified only for tasks using the Fargate launch type. If one isn't specified, the <code>LATEST</code> platform version is used.

clientTokenstring

The identifier that you provide to ensure the idempotency of the request. It's case sensitive and must be unique. It can be up to 32 ASCII characters are allowed.

Response

Success