AWS Builder Center: Learn, Build and Connect with builders in the AWS community

AWS Builder Center is the official home for builders on AWS. Share and read what others are working on, follow people who inspire you, explore training and workshops, and find tools to support what you're building.

AWS CLI コマンドを使用してサービスクォータ増加リクエストをリクエスト、表示、管理するにはどうすれば良いですか?

所要時間3分

AWS コマンドラインインターフェイス (AWS CLI) コマンドを使用してサービスクォータの増加をリクエストし、それらのリクエストを表示および管理したいと考えています。

簡単な説明

Service Quotas コンソールまたは AWS CLI コマンドを使用して、AWS サービスのクォータ (以前は制限と呼ばれていました) をリクエスト、表示、管理できます。

サービスクォータの AWS CLI コマンドのリストについては、「AWS CLI コマンドリファレンス」と「Service Quotas API リファレンス」を参照してください。

**注:**AWS CLI コマンドの実行中にエラーが発生した場合は、AWS CLI の最新バージョンを使用していることを確認してください。

AWS CLI を使用してサービスクォータを管理する場合は、次の点を確認してください:

特に明記されていない限り、クォータは各 AWS リージョンに固有です。コマンドの**--region** パラメータは、クォータの増加をリクエストしているリージョンに置き換えてください。
特定の時間に実行できるアクティブなサービスクォータリクエストには最大数があります。また、クォータ値は調整できません。詳細については、「Service Quotas 用のサービスクォータ」を参照してください。
API コマンドの出力は表形式で表示されます。出力をテキストまたは JSON 形式で表示するように変更する方法については、「AWS CLI からのコマンド出力の制御」を参照してください。

解決方法

**注:**Service Quotas で利用できる各 AWS サービスには、関連するサービスコードがあります。各サービス内で、使用可能なクォータタイプにはクォータコードがあります。サービスクォータ増加リクエストにはこれらのコードを含める必要があります。

list-services コマンドを実行すると、リージョンのサービスコードのリストが表示されます。eu-west-1 を自分のリージョンに置き換えてください:

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

list-service-quotas コマンドを実行すると、特定のサービスとリージョンで使用可能なクォータコードが表示されます。次の例では、--service-code と --region を特定のサービスとリージョンに置き換えてください。次の例では、eu-west-1 リージョンの Amazon Elastic Compute Cloud (Amazon EC2) のサービスクォータをリクエストしています。

# 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

サービスクォータの増加をリクエストする

サービスクォータの増加をリクエストする場合は、現在の制限を確認してから、特定のリージョンのサービスクォータを増加してください。

1.get-service-quota コマンドを実行して、クォータを増加するサービスに適用されているクォータ値を確認します。次の例では、eu-west-1 リージョンの Amazon EC2 の Elastic IP アドレス数に対するサービスクォータをリクエストしています。--service-code、--quota-code、--region をリクエストの値に置き換えてください。

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

2.クォータの増加をリクエストするには、request-service-quota-increase コマンドを使用してください。次の例では、eu-west-1 リージョンの Amazon EC2 の Elastic IP アドレス数に対するクォータの増加をリクエストしています。--service-code、--quota-code、--region をリクエストの値に置き換えてください。

# aws service-quotas request-service-quota-increase --service-code ec2 --quota-code L-0263D0A3 --region eu-west-1 --desired-value 10
{
    "RequestedQuota": {
        "Id": "d323c5f4eb8d400e96fbf34743b373a7YRHQ2y20",
        "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"
    }

リクエストを作成したら、Service Quotas コンソールを使用して新しいケースを追跡できます。または、AWS CLI を使用してリクエストのステータスを確認することもできます。

サービスクォータ増加リクエストのステータスを確認する

get-requested-service-quota-change コマンドを実行して、保留中のリクエストのステータスを確認します。次の例では、--request-id と --region をリクエストの値に置き換えます。出力には、ケース ID とリクエストのステータスが表示されます。

# aws service-quotas get-requested-service-quota-change --request-id "d323c5f4eb8d400e96fbf34743b373a7YRHQ2y20" --region eu-west-1
{
    "RequestedQuota": {
        "Id": "d323c5f4eb8d400e96fbf34743b373a7YRHQ2y20",
        "CaseId": "6672648091",
        "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"
    }
}

クォータ増加リクエストが CASE\ _CLOSED、APPROVED、 または DENIED ステータスになったら、リクエストの詳細を確認できます。サービスクォータ増加リクエストの履歴は 90 日間保存されます。詳細については、「ListRequestedServiceQuotaChangeHistoryByQuota」を参照してください。

# aws service-quotas get-requested-service-quota-change --request-id "d323c5f4eb8d400e96fbf34743b373a7YRHQ2y20" --region eu-west-1
{
    "RequestedQuota": {
        "Id": "d323c5f4eb8d400e96fbf34743b373a7YRHQ2y20",

                                          "CaseId": "6672648091",
        "ServiceCode": "ec2",
        "ServiceName": "Amazon Elastic Compute Cloud (Amazon EC2)",

                                    "QuotaCode": "L-0263D0A3",
        "QuotaName": "EC2-VPC Elastic IPs",
        "DesiredValue": 10.0,
        "Status": "CASE_CLOSED",

                                          "Created": 1576431516.421,
        "LastUpdated": 1576432913.04,
        "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"
    }
}

複数のサービスクォータ増加リクエストを追跡する

次の API を使用すると、特定のリージョンで行われたすべてのリクエスト（すべてのサービスとそのクォータコードを含む）を確認できます。また、クォータコード固有のリージョンに対して行われたすべてのリクエストを確認することもできます。

例 1

次のコマンドを実行して、特定のリージョンで行われたすべてのリクエスト（すべてのサービスとそのクォータコードを含む）のステータスを確認します:

# 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         |  2f919bc7e8b942e4a4d9e48b70e714547VLCFkjY  |  L-3D9CCA6E |  Tasks per Maintenance Window          |  APPROVED    |
|  6673136551|  10.0         |  cc07103300c74653911cebbd78739dacEToPmn3Z  |  L-DE82EABA |  Running Dedicated g3 Hosts            |  CASE_OPENED |
|  6673112701|  10.0         |  fb78996c9c364915825bab46f2b6a313J8FAIAFm  |  L-8CCBD91B |  Running On-Demand m5d hosts           |  CASE_OPENED |
|  6673109881|  10.0         |  06db5543f3a74dcda55346ca4812a6a0H4jikbty  |  L-24D7D4AD |  Running On-Demand m5n hosts           |  CASE_OPENED |
|  6673043811|  10.0         |  0cf070a56ae742acaf5143f5685d9cc8pGWjHH9l  |  L-0263D0A3 |  EC2-VPC Elastic IPs                   |  CASE_OPENED |
|  6672648091|  10.0         |  d323c5f4eb8d400e96fbf34743b373a7YRHQ2y20  |  L-0263D0A3 |  EC2-VPC Elastic IPs                   |  CASE_CLOSED |
+------------+---------------+--------------------------------------------+-------------+----------------------------------------+--------------+

例 2

次のコマンドを実行して、特定のクォータコードに対して行われたすべてのリクエストのステータスを確認します:

# 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     |
+------------+---------------+--------------------------------------------+-------------+----------------------------+---------------+
|  6673043811|  10.0         |  0cf070a56ae742acaf5143f5685d9cc8pGWjHH9l  |  L-0263D0A3 |  EC2-VPC Elastic IPs       |  CASE_OPENED  |
|  6672648091|  10.0         |  d323c5f4eb8d400e96fbf34743b373a7YRHQ2y20  |  L-0263D0A3 |  EC2-VPC Elastic IPs       |  CASE_CLOSED  |
+------------+---------------+--------------------------------------------+-------------+----------------------------+---------------+