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: 20 | 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: 1,000 | No | 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 |
| Services per namespace | Each supported Region: 100 |
Yes |
The maximum number of services that can be running within a namespace. |
| 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: 500 | 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 | No | The maximum number of tasks per service (the desired count). |
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.
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.
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.
Services configured to use Amazon ECS Service Connect 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.
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. |
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.
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