Amazon ECS service quotas - Amazon Elastic Container Service

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 or deleting 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.