Como posso solicitar, visualizar e gerenciar solicitações de aumento da cota de serviço usando os comandos da AWS CLI?

6 minuto de leitura
0

Quero usar os comandos da AWS Command Line Interface (AWS CLI) para solicitar aumento de cotas de serviço e, em seguida, visualizar e gerenciar essas solicitações.

Breve descrição

Você pode solicitar, visualizar e gerenciar cotas, antes conhecidas como limites, de serviços da AWS no console ](https://console.aws.amazon.com/servicequotas/home)Service Quotas[ ou por meio de comandos da AWS CLI.

Para obter uma lista de comandos da AWS CLI para cota de serviço, consulte a Referência de comandos da AWS CLI e a Referência da API para Service Quotas.

Observação: se você receber erros ao executar comandos da AWS CLI, verifique se está usando a versão mais recente da AWS CLI.

Ao usar a AWS CLI para gerenciar suas cotas de serviço, analise os seguintes pontos:

  • Salvo indicação em contrário, as cotas são específicas para cada região da AWS. Certifique-se de substituir o parâmetro \ --region em seus comandos pela Região em que você está solicitando o aumento de cota.
  • Há um número máximo de solicitações de cota de serviço ativas que você pode ter em um determinado momento. Além disso, não é possível ajustar os valores da cota. Para mais informações, consulte Service Quotas para cotas de serviço.
  • A saída dos comandos da API é exibida em formato de tabela. Para informações sobre como alterar a saída para que ela apareça em formato de texto ou JSON, consulte Controle da saída de comandos da AWS CLI.

Resolução

Observação: cada serviço da AWS disponível em Service Quotas tem um código de serviço associado. Em cada serviço, o tipo de cota disponível tem um código de cota. Você deve incluir esses códigos em suas solicitações de aumento de cota de serviço.

Execute o comando list-services para ver a lista de códigos de serviço de sua região. Substitua eu-west-1 por sua região:

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

Execute o comando list-service-quotas para ver os códigos de cota disponíveis de um determinado serviço e região. No exemplo a seguir, substitua \ --service-code e \ --region por seu serviço e região específicos. O exemplo a seguir solicita cotas de serviço para o Amazon Elastic Compute Cloud (Amazon EC2) na região eu-west-1.

# 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

Solicite o aumento da cota de serviço

Ao solicitar o aumento da cota de serviço, verifique o limite atual e, em seguida, aumente a cota de serviço de uma região específica.

1.    Execute o comando get-service-quota para verificar o valor da cota aplicada ao serviço que você deseja aumentar. O exemplo a seguir solicita a cota de serviço do número de endereços IP elásticos no Amazon EC2 na região eu-west-1. Substitua \ --service-code,\ --quota-code e **\ --region ** pelos valores da sua solicitação.

# 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.    Use o comando request-service-quota-increase para solicitar o aumento de cota. O exemplo a seguir solicita um aumento de cota para o número de endereços IP elásticos no Amazon EC2 na região eu-west-1. Substitua --service-code,**\ --quota-code **e \ --region pelos valores da sua solicitação.

# 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"
    }

Depois de criar a solicitação, você pode usar o console Service Quotas para rastrear o novo caso. Ou você pode usar a AWS CLI para verificar o status da solicitação.

Verificar o status de uma solicitação de aumento da cota de serviço

Execute o comando get-requested-service-quota-change para verificar o status de uma solicitação pendente. No exemplo a seguir, substitua \ --request-id e \ --region pelos valores da sua solicitação. A saída mostra a ID do caso e o Status da solicitação.

# 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"
    }
}

Depois que uma solicitação de aumento de cota atingir o status ** CASE_CLOSED, APPROVED** ou DENIED, você poderá verificar os detalhes da solicitação. O histórico de solicitações de aumento da cota de serviço é mantido por 90 dias. Para mais informações, consulte 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"
    }
}

Acompanhar diferentes solicitações de aumento de cotas de serviço

Usando as APIs abaixo, você pode verificar todas as solicitações feitas em uma determinada região, incluindo todos os serviços e seus códigos de cotas. Você também pode verificar todas as solicitações de código de cota feitas de uma região específica.

Exemplo 1

Execute o comando a seguir para verificar o status de todas as solicitações de uma região específica, incluindo todos os serviços e seus códigos de cota:

# 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 |
+------------+---------------+--------------------------------------------+-------------+----------------------------------------+--------------+

Exemplo 2

Execute o comando a seguir para verificar o status de todas as suas solicitações relativas a um código de cota específico:

# 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  |
+------------+---------------+--------------------------------------------+-------------+----------------------------+---------------+

Informações relacionadas

Como posso solucionar erros usando a AWS CLI para gerenciar minhas solicitações de Service Quotas?

O que são Service Quotas?

Introdução às Service Quotas: visualize e gerencie suas cotas para serviços da AWS em um só lugar

AWS OFICIAL
AWS OFICIALAtualizada há um ano