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

3 分钟阅读
0

我想使用 AWS 命令行界面 (AWS CLI) 命令来请求提高服务限额,然后查看并管理这些请求。

简短描述

您可以通过服务限额控制台或 AWS CLI 命令来请求、查看和管理 AWS 服务的限额(以前称为限值)。

有关服务限额 AWS CLI 命令的列表,请参阅 AWS CLI 命令参考服务限额 API 参考

**注意:**如果在运行 AWS CLI 命令时收到错误,请确认您使用的是最新版本的 AWS CLI

使用 AWS CLI 管理您的服务限额时,请注意以下几点:

  • 除非另有说明,否则每个 AWS 区域都有特定限额。务必将命令中的 --region 参数替换为您请求提高限额的区域。
  • 您在特定时间内能提出的有效服务限额请求的数量是有限的。此外,您无法调整限额数值。有关详细信息,请参阅服务限额的服务限额
  • API 命令的输出以表格形式显示。有关将输出更改为以文本或 JSON 格式显示的信息,请参阅控制 AWS CLI 的命令输出

解决方法

**注意:**服务限额中可用的每项 AWS 服务都有关联的服务代码。在每项服务中,可用的限额类型都有一个限额代码。您必须在服务限额提高请求中包括这些代码。

运行 list-services 命令,以查看您所在区域的服务代码列表。将 eu-west-1 替换为您的区域:

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

运行 list-service-quotas 命令,以查看特定服务和区域的可用限额代码。在以下示例中,将 --servicecode--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 弹性 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 弹性 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"
    }

在创建请求后,您可以使用服务限额控制台来跟踪请求进度。您还可以使用 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、APPROVEDDENIED 状态后,您可以查看此请求的详细信息。服务限额提高请求历史记录将保留 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  |
+------------+---------------+--------------------------------------------+-------------+----------------------------+---------------+

相关信息

如何使用 AWS CLI 排查错误以管理服务限额请求?

什么是服务限额?

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

AWS 官方
AWS 官方已更新 1 年前
没有评论