Comment puis-je demander, afficher et gérer des demandes d'augmentation du quota de service à l'aide des commandes de l'interface de ligne de commande AWS ?

Date de la dernière mise à jour : 08/09/2020

Comment puis-je demander une augmentation du quota de service, puis afficher et gérer ces demandes à l'aide des commandes de l'interface de ligne de commande AWS (AWS CLI) ?

Brève description

Vous pouvez demander, afficher et gérer des quotas de service AWS, anciennement appelés limites, à partir de la console de Service Quotas ou à l'aide des commandes AWS CLI.

Pour obtenir la liste des commandes AWS CLI de quota de service, consultez AWS CLI Command Reference et Service Quotas API Reference.

Lorsque vous utilisez l'interface de ligne de commande AWS pour gérer vos quotas de service, gardez à l'esprit les points suivants :

Résolution

Remarque : chaque service AWS disponible dans Service Quotas est associé à un code de service. Chaque type de quota disponible a un code de quota au sein de chaque service. Vous avez besoin de ces codes pour demander des augmentations de quota de service.

Exécutez la commande list-services pour afficher la liste des codes de service de votre région. Remplacez eu-west-1 par votre région :

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

Exécutez la commande list-service-quota pour voir les codes de quota disponibles pour un service et une région particuliers. Dans l'exemple suivant, remplacez --service-cod et --region par votre service et votre région spécifiques. L'exemple suivant demande des quotas de service pour Amazon Elastic Compute Cloud (Amazon EC2) dans la région 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

Demander une augmentation de quota de service

Lorsque vous demandez une augmentation du quota de service, vérifiez la limite actuelle, puis augmentez le quota de service dans une région AWS particulière.

1.    Exécutez la commande get-service-quota pour vérifier la valeur de quota appliquée pour le service que vous souhaitez augmenter. L'exemple suivant demande le quota de service pour le nombre d'EIP dans EC2 dans la région eu-ouest-1. Remplacez les valeurs --service-code, --quota-code, et --region par les valeurs appropriées pour votre demande.

# 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.    Demander une augmentation de quota à l'aide de la commande request-service-quota-augmentation. L'exemple suivant demande une augmentation du quota pour le nombre de PIE dans EC2 dans la région eu-ouest-1. Remplacez les valeurs --service-code, --quota-code, et --region par les valeurs appropriées pour votre demande.

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

Après avoir créé la demande, vous pouvez suivre le nouveau cas à l'aide de la console de Service Quotas. Vous pouvez également utiliser l'interface de ligne de commande AWS pour vérifier l'état de la demande.

Vérifier l'état d'une demande d'augmentation de quota de service

Exécutez la commande get-requested-service-quota-change pour vérifier l'état d'une demande en attente. Dans l'exemple suivant, remplacez --request-id et --region par les valeurs de votre requête. La sortie affiche l'ID du dossier et le l'état de la demande.

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

Une fois qu'une demande d'augmentation de quota atteint l'état CASE_CLOWED, APPROVED, ou REFUSED vous pouvez vérifier les détails de la demande. L'historique des demandes d'augmentation du quota de service est conservé pendant 90 jours. Pour plus d'informations, consultez 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"
    }
}

Suivi des demandes d'augmentation de quota de services multiples

En utilisant les API suivantes, vous pouvez vérifier :

  • Toutes les demandes faites dans une région donnée, y compris tous les services et tous leurs codes de quotas respectifs.
  • Toutes les demandes faites pour une région particulière spécifique à un code de quota particulier.

Exemple 1

Exécutez la commande suivante pour vérifier l'état de toutes les demandes effectuées dans une région spécifique, y compris tous les services et leurs codes de quota associés :

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

Exemple 2

Exécutez la commande suivante pour vérifier l'état de toutes vos demandes faites pour un code de quota spécifique :

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