AWS Fundamentals Logo
AWS Fundamentals
AWS::ECS::TaskSet

ECS TaskSet

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

Properties

12 configurable properties. 3 required. Click a row to see details.

Filter:
PropertyTypeFlags
Cluster
string
RequiredCreate-only
Service
string
RequiredCreate-only
TaskDefinition
string
RequiredCreate-only
CapacityProviderStrategy
Array<CapacityProviderStrategyItem>
Create-only
ExternalId
string
Create-only
LaunchType
string
Create-only
LoadBalancers
Array<LoadBalancer>
Create-only
NetworkConfiguration
NetworkConfiguration
Create-only
PlatformVersion
string
Create-only
Scale
Scale
ServiceRegistries
Array<ServiceRegistry>
Create-only
Tags
Array<Tag>

Return Values

Values returned after the resource is created. Access these with Fn::GetAtt.

AttributeTypeDescription
IdstringThe ID of the task set.

Sample CloudFormation Template

A minimal template with required properties and common optional ones.

template.yaml
AWSTemplateFormatVersion: "2010-09-09"
Description: Sample template for AWS::ECS::TaskSet

Resources:
  MyResource:
    Type: AWS::ECS::TaskSet
    Properties:
      Cluster: "value"
      Service: "value"
      TaskDefinition: "value"
      Tags:
        - Key: Environment
          Value: Production

Required IAM Permissions

Permissions CloudFormation needs in your IAM role to manage this resource.

read

ecs:DescribeTaskSets

create

ecs:CreateTaskSetecs:DescribeTaskSetsecs:TagResource

update

ecs:DescribeTaskSetsecs:TagResourceecs:UntagResourceecs:UpdateTaskSet

delete

ecs:DeleteTaskSetecs:DescribeTaskSets

Get the ECS Cheat Sheet

Everything you need to know about ECS on one page. HD quality, print-friendly.

Download Free Infographic

Quick Facts

ServiceECS
Properties13
Required3
TaggingSupported
Primary IDCluster

Supported Operations

ReadCreateUpdateDelete

Immutable After Creation

These properties cannot be changed after the resource is created. Updating them triggers a replacement.

ClusterExternalIdLaunchTypeLoadBalancersNetworkConfigurationPlatformVersionServiceServiceRegistriesTaskDefinitionCapacityProviderStrategy

Related Resources

External Links