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

5분 분량
0

AWS Command Line Interface(AWS CLI) 명령을 사용하여 서비스 할당량 증가를 요청한 다음 해당 요청을 확인하고 관리하려고 합니다.

간략한 설명

Service Quotas 콘솔 또는 AWS CLI 명령을 사용하여 AWS 서비스에 대한 할당량(이전 이름: 제한)을 요청, 확인, 관리할 수 있습니다.

서비스 할당량 AWS CLI 명령 목록은 AWS CLI 명령 참조서비스 할당량 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 명령을 실행하여 특정 서비스 및 리전에 대해 사용 가능한 할당량 코드를 확인합니다. 다음 예제에서는 --서비스 코드--지역을 특정 서비스 및 지역으로 바꿉니다. 다음 예는 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
    }
}
  1. 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, 승인됨, 또는 거부됨 상태가 되면 요청 세부 정보를 확인할 수 있습니다. 서비스 할당량 증가 요청 내역은 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를 사용하여 오류를 해결하려면 어떻게 해야 하나요?

Service Quotas란 무엇인가요?

Service Quotas 소개: AWS 서비스 할당량을 확인하고 관리할 수 있는 중앙 관리 위치

AWS 공식
AWS 공식업데이트됨 일 년 전