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 ?

Lecture de 6 minute(s)
0

Je souhaite utiliser les commandes de l’interface de ligne de commande AWS (AWS CLI) pour demander des augmentations de quotas de service, puis consulter et gérer ces demandes.

Brève description

Vous pouvez demander, consulter et gérer des quotas, anciennement appelés limites, pour les services AWS à partir de la console Service Quotas ou à l’aide des commandes de l’interface de ligne de commande AWS (AWS CLI).

Pour obtenir la liste des commandes de l’AWS CLI à quota de service, consultez la référence des commandes de l’AWS CLI et la référence de l’API Service Quotas.

**Remarque :**Si vous recevez des erreurs lors de l’exécution des commandes de l’AWS CLI, assurez-vous que vous utilisez la version la plus récente de l’AWS CLI.

Lorsque vous utilisez l’AWS CLI pour gérer vos quotas de service, passez en revue les points suivants :

  • Sauf indication contraire, les quotas sont spécifiques à chaque région AWS. Assurez-vous de remplacer le paramètre --region dans vos commandes par la région dans laquelle vous demandez une augmentation de quota.
  • Il existe un nombre maximum de demandes de quota de service actives que vous pouvez avoir à un moment donné. De plus, vous ne pouvez pas ajuster les valeurs des quotas. Pour plus d’informations, voir Quotas de service pour Service Quotas.
  • La sortie des commandes de l’API s’affiche sous forme de tableau. Pour plus d’informations sur la modification de la sortie afin qu’elle apparaisse au format texte ou JSON, consultez la section Contrôle de la sortie des commandes depuis l’AWS CLI.

Résolution

Remarque : Chaque service AWS disponible dans Service Quotas est associé à un code de service. Au sein de chaque service, le type de quota disponible possède un code de quota. Vous devez inclure ces codes dans vos demandes d’augmentation de quota de service.

Exécutez la commande list-services pour voir la liste des codes de service pour 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-quotas pour voir les codes de quota disponibles pour un service et une région spécifiques. Dans l’exemple suivant, remplacez --service-code et --region par votre service et votre région spécifiques. Dans l’exemple suivant, on peut voir une demande de 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 du 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 donnée.

1.    Exécutez la commande get-service-quota pour vérifier la valeur de quota appliquée au service que vous souhaitez augmenter. Dans l’exemple suivant, il est demandé le quota de service pour le nombre d’adresses IP Elastic dans Amazon EC2 dans la région eu-west-1. Remplacez --service-code, --quota-code et --region par les valeurs correspondant à 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": "EC2-VPC Elastic IPs",
        "Value": 5.0,
        "Unit": "None",
        "Adjustable": true,
        "GlobalQuota": false
    }
}

2.    Utilisez la commande request-service-quota-increase pour demander une augmentation de quota. Dans l’exemple suivant, il est demandé l’augmentation de quota pour le nombre d’adresses IP Elastic dans Amazon EC2 dans la région eu-west-1. Remplacez --service-code, --quota-code et --region par les valeurs correspondant à 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": "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"
    }

Après avoir créé la demande, vous pouvez utiliser la console Service Quotas pour suivre le nouveau dossier. Vous pouvez également utiliser l’AWS CLI pour vérifier l’état de la demande.

Vérifier l’état d’une demande d’augmentation du 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 demande. La sortie affiche l’ID du dossier et 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": "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"
    }
}

Une fois qu’une demande d’augmentation de quota atteint l’état CASE_CLOSED, APPROVED ou DENIED, 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": "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"
    }
}

Suivre plusieurs demandes d’augmentation des quotas de service

À l’aide des API suivantes, vous pouvez vérifier toutes les demandes effectuées dans une région donnée, y compris tous les services et leurs codes de quotas. Vous pouvez également vérifier toutes les demandes qui ont été faites pour une région spécifique à un code de quota.

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 :

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

Exemple 2

Exécutez la commande suivante pour vérifier l’état de toutes vos demandes 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 |  EC2-VPC Elastic IPs       |  CASE_OPENED  |
|  6672648091|  10.0         |  d323c5f4eb8d400e96fbf34743b373a7YRHQ2y20  |  L-0263D0A3 |  EC2-VPC Elastic IPs       |  CASE_CLOSED  |
+------------+---------------+--------------------------------------------+-------------+----------------------------+---------------+

Informations connexes

Comment puis-je résoudre les erreurs à l’aide de l’AWS CLI pour gérer mes demandes de quota de service ? 

Qu’est-ce que Service Quotas ?

Présentation de Service Quotas : consultez et gérez vos quotas pour les services AWS à partir d’un emplacement central

AWS OFFICIEL
AWS OFFICIELA mis à jour il y a un an