Amazon ECS service quotas - Amazon ECS

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 on 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 on 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: 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 AWS Fargate Each supported Region: 500 Yes 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 Yes 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 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 will see variations in task launch rates compared with the quotas represented above based on 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.

AWS Fargate service quotas

The following are Amazon ECS on AWS Fargate service quotas.

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 resource count Each supported Region: 1,000 Yes The maximum number of Amazon ECS tasks and Amazon EKS pods running concurrently on Fargate in this account in the current Region.
Fargate Spot resource count Each supported Region: 1,000 Yes The maximum number of Amazon ECS tasks running concurrently on 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.

AWS Management Console

To view Amazon ECS and Fargate service quotas using the AWS Management Console

  1. Open the Service Quotas console at https://console.aws.amazon.com/servicequotas/.

  2. In the navigation pane, choose AWS services.

  3. From the AWS services list, search for and select Amazon Elastic Container Service (Amazon ECS) or AWS Fargate.

    In the Service quotas list, you can see the service quota name, applied value (if it is available), AWS default quota, and whether the quota value is adjustable.

  4. To view additional information about a service quota, such as the description, choose the quota name.

  5. (Optional) To request a quota increase, select the quota that you want to increase, select Request quota increase, enter or select the required information, and select Request.

To work more with service quotas using the AWS Management Console see the Service Quotas User Guide. To request a quota increase, see Requesting a quota increase in the Service Quotas User Guide.

AWS CLI

To view Amazon ECS and Fargate service quotas using the AWS CLI

Run the following command to view the default Amazon ECS quotas.

aws service-quotas list-aws-default-service-quotas \ --query 'Quotas[*].{Adjustable:Adjustable,Name:QuotaName,Value:Value,Code:QuotaCode}' \ --service-code ecs \ --output table

Run the following command to view the default Fargate quotas.

aws service-quotas list-aws-default-service-quotas \ --query 'Quotas[*].{Adjustable:Adjustable,Name:QuotaName,Value:Value,Code:QuotaCode}' \ --service-code fargate \ --output table

Run the following command to view your applied Fargate quotas.

aws service-quotas list-service-quotas \ --service-code fargate
Note

Amazon ECS does not support applied quotas.

To work more with service quotas using the AWS CLI, see the Service Quotas AWS CLI Command Reference. To request a quota increase, see the request-service-quota-increase command in the AWS CLI Command Reference.