AWS Fundamentals Logo
AWS Fundamentals
AWS::ECS::Cluster

ECS Cluster

The AWS::ECS::Cluster resource creates an Amazon Elastic Container Service (Amazon ECS) cluster.

Properties

7 configurable properties. Click a row to see details.

Filter:
PropertyTypeFlags
CapacityProviders
Array<string>
ClusterName
string
Create-only
ClusterSettings
Array<ClusterSettings>
Configuration
ClusterConfiguration
DefaultCapacityProviderStrategy
Array<CapacityProviderStrategyItem>
ServiceConnectDefaults
ServiceConnectDefaults
Write-only
Tags
Array<Tag>

Return Values

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

AttributeTypeDescription
Arnstring-

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::Cluster

Resources:
  MyResource:
    Type: AWS::ECS::Cluster
    Properties:
      Tags:
        - Key: Environment
          Value: Production

Required IAM Permissions

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

read

ecs:DescribeClusterskms:DescribeKey

create

ecs:CreateClusterecs:DescribeClustersiam:CreateServiceLinkedRoleecs:TagResourcekms:DescribeKey

update

ecs:PutAccountSettingDefaultecs:DescribeClustersecs:TagResourceecs:UntagResourceecs:PutAccountSettingecs:ListTagsForResourceecs:UpdateClusterecs:UpdateClusterSettings

list

ecs:DescribeClustersecs:ListClusters

delete

ecs:DeleteClusterecs:DescribeClusterskms:DescribeKey

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
Properties8
Required0
TaggingSupported
Primary IDClusterName

Supported Operations

ReadCreateUpdateListDelete

Immutable After Creation

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

ClusterName

Related Resources

External Links