Amazon ECS service quotas
The following tables provide the default service quotas, also referred to as limits, for Amazon ECS for an AWS account. For more information about the service quotas for other AWS services that you can use with Amazon ECS, such as Elastic Load Balancing and Auto Scaling, see AWS 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.
New AWS accounts might have initial lower quotas that can increase over time. Amazon ECS constantly monitors the account usage within each Region, and then automatically increases the quotas based on your usage. You can also request a quota increase for values that are shown as adjustable, see Requesting a quota increase in the Service Quotas User Guide.
| 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 AWS 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). |
Note
The default values are the initial quotas set by AWS, 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 AWS Cloud Map service quota for the number of instances per service. For more information, see AWS 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.
Note
Services configured to use Amazon ECS Service Connect have a limit of 1,000 tasks per service. This is due to the AWS Cloud Map service quota for the number of instances per service. For more information, see AWS Cloud Map service quotas in the Amazon Web Services General Reference.
AWS Fargate service quotas
The following are Amazon ECS on AWS Fargate service quotas and are listed under the AWS Fargate service in the Service Quotas console.
New AWS accounts might have initial lower quotas that can increase over time. Fargate constantly monitors the account usage within each Region, and then automatically increases the quotas based on your usage. You can also request a quota increase for values that are shown as adjustable, see Requesting a quota increase in the Service Quotas User Guide.
| 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 AWS, 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 AWS Fargate service quotas in the AWS Management Console
Amazon ECS has integrated with Service Quotas, an AWS service that enables you to view and manage your quotas from a central location. For more information, see What Is Service Quotas? in the Service Quotas User Guide.
Service Quotas makes it easy to look up the value of your Amazon ECS service quotas.
