How do I use AWS CLI commands to request, view, and manage service quota increases?

Resolution

Note: If you receive errors when you run AWS CLI commands, then see Troubleshooting errors for the AWS CLI. Also, make sure that you're using the most recent AWS CLI version.

To request, view, or manage quota increases, you can use the Service Quotas console or the AWS CLI.

To view the maximum number of active service quota requests that you can submit, see Service quotas for Service Quotas.

Check your service and quota codes

Each AWS service that you can request quota increases for has an associated service code, and each available quota type has a quota code. You must use these codes in your service quota increase requests.

To see the list of service codes for your AWS Region, run the following list-services AWS CLI command:

aws service-quotas list-services --region eu-west-1 --output table

Note: Replace eu-west-1 with your Region.

To see available quota codes for a specific service and Region, run the following list-service-quotas command:

aws service-quotas list-service-quotas --service-code ec2 --region eu-west-1 --query "Quotas[*].{ServiceName:ServiceName,QuotaName:QuotaName,QuotaCode:QuotaCode,Value:Value}" --output table

Note: Replace ec2 with your service code and eu-west-1 with your Region.

Request a service quota increase

Complete the following steps:

1. To check the quotas for the service that you want to increase, run the following get-service-quota command:

   aws service-quotas get-service-quota --service-code ec2 --quota-code L-12345678 --region eu-west-1

   Note: Replace ec2 with your service code, L-12345678 with your quota code, and eu-west-1 with your Region.
   Example output:

   # aws service-quotas get-service-quota --service-code ec2 --quota-code L-12345678 --region eu-west-1{
       "Quota": {
           "ServiceCode": "ec2",
           "ServiceName": "Amazon Elastic Compute Cloud (Amazon EC2)",
           "QuotaArn": "arn:aws:servicequotas:eu-west-1:111122223333:ec2/L-12345678",
           "QuotaCode": "L-0263D0A3",
           "QuotaName": "EC2-VPC Elastic IPs",
           "Value": 5.0,
           "Unit": "None",
           "Adjustable": true,
           "GlobalQuota": false
       }
   }

2. To request a quota increase, run the following request-service-quota-increase command:

   aws service-quotas request-service-quota-increase --service-code ec2 --quota-code L-12345678 --region eu-west-1 --desired-value 10

   Note: Replace ec2 with your service code, L-12345678 with your quota code, eu-west-1 with your Region, and 10 with your increase value.
   Example output:

   # aws service-quotas request-service-quota-increase --service-code ec2 --quota-code L-12345678 --region eu-west-1 --desired-value 10{
       "RequestedQuota": {
           "Id": "abcde12345abcde12345",
           "ServiceCode": "ec2",
           "ServiceName": "Amazon Elastic Compute Cloud (Amazon EC2)",
           "QuotaCode": "L-0263D0A3",
           "QuotaName": "EC2-VPC Elastic IPs",
           "DesiredValue": 10.0,
           "Status": "PENDING",
           "Created": 1576431516.421,
           "Requester": "{\"accountId\":\"111122223333\",\"callerArn\":\"arn:aws:iam::111122223333:user/testeksuser\"}",
           "QuotaArn": "arn:aws:servicequotas:eu-west-1:111122223333:ec2/L-0263D0A3",
           "GlobalQuota": false,
           "Unit": "None"
       }

   In the output, note the Id value to get the service quota request ID.

Check the status of a service quota increase request

To check the status of a pending request, run the following get-requested-service-quota-change command:

aws service-quotas get-requested-service-quota-change --request-id "abcdefg12345678" --region eu-west-1

Note: Replace abcdefg12345678 with your request ID and eu-west-1 with your Region.

In the output, check the CaseId and Status values for your request.

Example output:

# aws service-quotas get-requested-service-quota-change --request-id "abcdefg12345678" --region eu-west-1{
    "RequestedQuota": {
        "Id": "abcdefg123455678",
        "CaseId": "123456789",
        "ServiceCode": "ec2",
        "ServiceName": "Amazon Elastic Compute Cloud (Amazon EC2)",
        "QuotaCode": "L-0263D0A3",
        "QuotaName": "EC2-VPC Elastic IPs",
        "DesiredValue": 10.0,
        "Status": "CASE_OPENED",
        "Created": 1576431516.421,
        "LastUpdated": 1576431520.527,
        "Requester": "{\"accountId\":\"111122223333\",\"callerArn\":\"arn:aws:iam::111122223333:user/testeksuser\"}",
        "QuotaArn": "arn:aws:servicequotas:eu-west-1:111122223333:ec2/L-0263D0A3",
        "GlobalQuota": false,
        "Unit": "None"
    }
}

Track multiple service quota increase requests

To check the status of all the service quota requests in a specific Region, run the following list-requested-service-quota-change-history command:

aws service-quotas list-requested-service-quota-change-history --region eu-west-1 --query "RequestedQuotas[*].{CaseId:CaseId,Id:Id,QuotaCode:QuotaCode,QuotaName:QuotaName,DesiredValue:DesiredValue,Status:Status}" --output table

Note: Replace eu-west-1 with your Region.

Example output:

# aws service-quotas list-requested-service-quota-change-history --region eu-west-1 --query "RequestedQuotas[*].{CaseId:CaseId,Id:Id,QuotaCode:QuotaCode,QuotaName:QuotaName,DesiredValue:DesiredValue,Status:Status}" --output table-------------------------------------------------------------------------------------------------------------------------------------------------
|                                                    ListRequestedServiceQuotaChangeHistory                                                     |
+------------+---------------+--------------------------------------------+-------------+----------------------------------------+--------------+
|   CaseId   | DesiredValue  |                    Id                      |  QuotaCode  |               QuotaName                |   Status     |
+------------+---------------+--------------------------------------------+-------------+----------------------------------------+--------------+
|  None      |  50.0         |  abcdefg1234567acbdefg1234567abcdefg12345  |  L-12345678 |  Tasks per Maintenance Window          |  APPROVED    |
|  1234567890|  10.0         |  abcdefg1234567acbdefg1234567abcdefg12345  |  L-12345678 |  Running Dedicated g3 Hosts            |  CASE_OPENED |
|  1234567890|  10.0         |  abcdefg1234567acbdefg1234567abcdefg12345  |  L-12345678 |  Running On-Demand m5d hosts           |  CASE_OPENED |
|  1234567890|  10.0         |  abcdefg1234567acbdefg1234567abcdefg12345  |  L-12345678 |  Running On-Demand m5n hosts           |  CASE_OPENED |
|  1234567890|  10.0         |  abcdefg1234567acbdefg1234567abcdefg12345  |  L-12345678 |  EC2-VPC Elastic IPs                   |  CASE_OPENED |
|  1234567890|  10.0         |  abcdefg1234567acbdefg1234567abcdefg12345  |  L-12345678 |  EC2-VPC Elastic IPs                   |  CASE_CLOSED |
+------------+---------------+--------------------------------------------+-------------+----------------------------------------+--------------+

To check the status of all the requests for a specific quota code, run the following list-requested-service-quota-change-history command:

aws service-quotas list-requested-service-quota-change-history-by-quota --service-code ec2 --quota-code L-12345678--region eu-west-1 --query "RequestedQuotas[*].{CaseId:CaseId,Id:Id,QuotaCode:QuotaCode,QuotaName:QuotaName,DesiredValue:DesiredValue,Status:Status}" --output table

Note: Replace ec2 with your service code, L-12345678 with your quota code, and eu-west-1 with your Region.

Example output:

# aws service-quotas list-requested-service-quota-change-history-by-quota --service-code ec2 --quota-code L-0263D0A3 --region eu-west-1 --query "RequestedQuotas[*].{CaseId:CaseId,Id:Id,QuotaCode:QuotaCode,QuotaName:QuotaName,DesiredValue:DesiredValue,Status:Status}" --output table--------------------------------------------------------------------------------------------------------------------------------------
|                                            ListRequestedServiceQuotaChangeHistoryByQuota                                           |
+------------+---------------+--------------------------------------------+-------------+----------------------------+---------------+
|   CaseId   | DesiredValue  |                    Id                      |  QuotaCode  |         QuotaName          |    Status     |
+------------+---------------+--------------------------------------------+-------------+----------------------------+---------------+
|  1234567890|  10.0         |  abcdefg1234567acbdefg1234567abcdefg12345  |  L-12345678 |  EC2-VPC Elastic IPs       |  CASE_OPENED  |
|  1234567890|  10.0         |  abcdefg1234567acbdefg1234567abcdefg12345  |  L-12345678 |  EC2-VPC Elastic IPs       |  CASE_CLOSED  |
+------------+---------------+--------------------------------------------+-------------+----------------------------+---------------+

For a list AWS CLI commands related to service quotas, see Actions.

Related information

How can I troubleshoot errors using the AWS CLI to manage my service quota requests?

What is Service Quotas?