如何使用 AWS CLI 命令请求、查看和管理提高服务配额的请求?

3 分钟阅读
0

如何申请提高服务配额,然后使用 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-quota 命令,查看特定服务和区域的可用配额代码。在以下示例中,将 --service-code 和 --region 替换为您的具体服务和区域。以下示例请求为 eu-west-1 区域中的 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

请求提高服务配额

请求提高服务配额时,请检查当前限制,然后在特定 AWS 区域中提高服务配额。

1.    运行 get-service-quota 命令,检查您要提高配额的服务的已应用配额值。以下示例请求为 eu-west-1 区域中的 EC2 中的 EIP 数量提高服务配额。将 --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": "Number of EIPs - VPC EIPs",
        "Value": 5.0,
        "Unit": "None",
        "Adjustable": true,
        "GlobalQuota": false
    }
}

2.    使用 request-service-quota-increase 命令来请求提高配额。以下示例请求为 eu-west-1 区域中的 EC2 中的 EIP 数量提高配额。将 --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": "Number of EIPs - VPC EIPs",
        "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": "Number of EIPs - VPC EIPs",
        "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_CLOSEDAPPROVEDDENIED 状态后,您可以查看请求的详细信息。提高服务配额请求的历史记录将保留 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": "Number of EIPs - VPC EIPs",
        "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 |  Number of EIPs - VPC EIPs             |  CASE_OPENED |
|  6672648091|  10.0         |  d323c5f4eb8d400e96fbf34743b373a7YRHQ2y20  |  L-0263D0A3 |  Number of EIPs - VPC EIPs             |  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 |  Number of EIPs - VPC EIPs |  CASE_OPENED  |
|  6672648091|  10.0         |  d323c5f4eb8d400e96fbf34743b373a7YRHQ2y20  |  L-0263D0A3 |  Number of EIPs - VPC EIPs |  CASE_CLOSED  |
+------------+---------------+--------------------------------------------+-------------+----------------------------+---------------+

相关信息

如何使用 AWS CLI 来管理 Service Quota 请求,进而排查出现的错误?

什么是 Service Quotas?

Service Quotas 简介:从一个位置集中查看和管理 AWS 服务的配额

AWS 官方
AWS 官方已更新 3 年前