AWS CLI 명령을 사용하여 서비스 할당량 증가 요청을 요청, 확인 및 관리하려면 어떻게 해야 합니까?

최종 업데이트 날짜: 2020년 9월 8일

AWS 명령줄 인터페이스(AWS CLI) 명령을 사용하여 서비스 할당량 증가를 요청한 다음, 해당 요청을 보고 관리하려면 어떻게 해야 합니까?

간략한 설명

Service Quotas 콘솔에서 또는 AWS CLI 명령을 사용해 AWS 서비스 할당량(이전의 ‘제한’)을 요청, 확인 및 관리할 수 있습니다.

서비스 할당량 AWS CLI 명령 목록은 AWS CLI 명령 참조Service Quotas API 참조를 참조하십시오.

AWS CLI를 사용하여 서비스 할당량을 관리하는 경우 다음 사항에 유의하십시오.

  • AWS CLI 명령을 실행할 때 오류가 발생하는 경우 최신 버전의 AWS CLI를 사용하고 있는지 확인하십시오.
  • 다른 언급이 없는 한, 각 할당량은 리전별로 다릅니다. 명령에서 --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 리전의 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

서비스 할당량 증가 요청

서비스 할당량 증가를 요청할 때 현재 제한을 확인한 다음 특정 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(Case ID) 및 요청의 상태(Status)가 표시됩니다.

# 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_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": "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  |
+------------+---------------+--------------------------------------------+-------------+----------------------------+---------------+