Amazon ECS service quotas - Amazon Elastic Container Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Amazon ECS service quotas

The following tables provide the default service quotas, also referred to as limits, for Amazon ECS for an Amazon Web Services account. For more information about the service quotas for other Amazon Web Services that you can use with Amazon ECS, such as Elastic Load Balancing and Auto Scaling, see Amazon service quotas in the Amazon Web Services General Reference. For information about API throttling in the Amazon ECS API, see Request throttling for the Amazon ECS API.

Amazon ECS service quotas

The following are Amazon ECS service quotas.

Name Default Adjustable Description
Capacity providers per cluster Each supported Region: 10 No The maximum number of capacity providers that can be associated with a cluster.
Classic Load Balancers per service Each supported Region: 1 No The maximum number of Classic Load Balancers per service.
Clusters per account Each supported Region: 10,000 Yes Number of clusters per account
Container instances per cluster Each supported Region: 5,000 No Number of container instances per cluster
Container instances per start-task Each supported Region: 10 No The maximum number of container instances specified in a StartTask API action.
Containers per task definition Each supported Region: 10 No The maximum number of containers definitions within a task definition.
ECS Exec sessions Each supported Region: 20 Yes The maximum number of ECS Exec sessions per container.
Rate of tasks launched by a service on Amazon Fargate Each supported Region: 500 No The maximum number of tasks that can be provisioned per service per minute on Fargate by the Amazon ECS service scheduler.
Rate of tasks launched by a service on an Amazon EC2 or External instance Each supported Region: 500 No The maximum number of tasks that can be provisioned per service per minute on an Amazon EC2 or External instance by the Amazon ECS service scheduler.
Revisions per task definition family Each supported Region: 1,000,000 No The maximum number of revisions per task definition family. Deregistering a task definition revision does not exclude it from being included in this limit.
Security groups per awsvpcConfiguration Each supported Region: 5 No The maximum number of security groups specified within an awsvpcConfiguration.
Services per cluster Each supported Region: 5,000 Yes The maximum number of services per cluster
Subnets per awsvpcConfiguration Each supported Region: 16 No The maximum number of subnets specified within an awsvpcConfiguration.
Tags per resource Each supported Region: 50 No The maximum number of tags per resource. This applies to task definitions, clusters, tasks, and services.
Target groups per service Each supported Region: 5 No The maximum number of target groups per service, if using an Application Load Balancer or a Network Load Balancer.
Task definition size Each supported Region: 64 Kilobytes No The maximum size, in KiB, of a task definition.
Tasks in PROVISIONING state per cluster Each supported Region: 300 No The maximum number of tasks waiting in the PROVISIONING state per cluster. This quota only applies to tasks launched using an EC2 Auto Scaling group capacity provider.
Tasks launched per run-task Each supported Region: 10 No The maximum number of tasks that can be launched per RunTask API action.
Tasks per service Each supported Region: 5,000 Yes The maximum number of tasks per service (the desired count).
Note

The default values are the initial quotas set by Amazon, which are separate from the actual applied quota value and maximum possible service quota. For more information, see Terminology in Service Quotas in the Service Quotas User Guide.

Note

Services configured to use Amazon ECS service discovery have a limit of 1,000 tasks per service. This is due to the Amazon Cloud Map service quota for the number of instances per service. For more information, see Amazon Cloud Map service quotas in the Amazon Web Services General Reference.

Note

In practice, task launch rates are also dependent on other considerations such as container images to be downloaded and unpacked, health checks and other integrations enabled, such as registering tasks with a load balancer. You might see variations in task launch rates compared with the quotas that are represented here. These variations are causes by the features that you have enabled for your Amazon ECS services. For more information, see speeding up Amazon ECS deployments in the Amazon ECS Best Practices Guide.

Amazon Fargate service quotas

The following are Amazon ECS on Amazon Fargate service quotas and are listed under the Amazon Fargate service in the Service Quotas console.

Name Default Adjustable Description
Fargate On-Demand vCPU resource count Each supported Region: 6 Yes The number of Fargate vCPUs running concurrently as Fargate On-Demand in this account in the current Region.
Fargate Spot vCPU resource count Each supported Region: 6 Yes The number of Fargate vCPUs running concurrently as Fargate Spot in this account in the current Region.
Note

The default values are the initial quotas set by Amazon, which are separate from the actual applied quota value and maximum possible service quota. For more information, see Terminology in Service Quotas in the Service Quotas User Guide.

Note

Fargate additionally enforces Amazon ECS tasks and Amazon EKS pods launch rate limits. For more information, see Fargate throttling limits.

Managing your Amazon ECS and Amazon Fargate service quotas

You can request an increase for Fargate quotas for your Amazon account. To request a quota adjustment, contact the Amazon Web Services Support Center.