Como posso solicitar, visualizar e gerenciar solicitações de aumento da cota de serviço usando os comandos da AWS CLI?
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?
Introdução às Service Quotas: visualize e gerencie suas cotas para serviços da AWS em um só lugar
Conteúdo relevante
- AWS OFICIALAtualizada há 3 anos
- Como solicito um aumento de cotas de serviço de vCPU para minha instância sob demanda do Amazon EC2?AWS OFICIALAtualizada há 4 meses
- AWS OFICIALAtualizada há um ano
- AWS OFICIALAtualizada há 2 anos