Gérer les quotas à l'aide de la CLI gcloud bêta

Preview

Cette fonctionnalité est soumise(s) aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités de pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Les sections suivantes contiennent des exemples de commandes gcloud beta quotas info et gcloud beta quotas preferences. Ces commandes vous permettent d'afficher et de gérer les ressources QuotaInfo et QuotaPreference.

Vous pouvez utiliser Google Cloud CLI (gcloud CLI) pour obtenir des quotas et des préférences de quota pour certaines API et certains services Google Cloud .

Limites

Cloud Quotas présente les limites suivantes :

• Dans la plupart des cas, les ajustements d'augmentation de quota doivent être effectués au niveau du projet. Un nombre limité de produits sont compatibles avec les ajustements d'augmentation de quota au niveau de l'organisation. Pour savoir si un produit Google Cloud accepte les ajustements d'augmentation de quota au niveau de l'organisation, consultez la documentation de ce produit.

• Vous pouvez demander des ajustements de diminution de quota pour les quotas au niveau du projet, de l'organisation et du dossier.

Avant de commencer

Avant d'utiliser la gcloud CLI, assurez-vous d'installer et d'initialiser la gcloud CLI.

Vous aurez peut-être également besoin de votre valeur QUOTA_ID. Si c'est le cas, consultez les instructions pour trouver votre ID de quota.

Installer et initialiser gcloud CLI

Pour utiliser gcloud CLI pour les quotas cloud, veillez à installer et à initialiser les composants :

1. Installez gcloud CLI.

   Si vous utilisez Cloud Shell, vous pouvez ignorer cette étape, car gcloud CLI est préinstallé.

2. Initialisez gcloud CLI.

3. Installez le composant bêta en exécutant la commande suivante :

   gcloud components install beta
   

Trouver votre ID de quota

Plusieurs commandes de la gcloud CLI dans ce document font référence à votre ID de quota. Vous pouvez trouver l'ID de quota à l'aide de la console Google Cloud , de gcloud CLI, des bibliothèques clientes ou de l'API REST. Cette section explique comment trouver l'ID de quota à l'aide de la console Google Cloud ou de gcloud CLI.

Console

1. Dans la console Google Cloud , accédez à la page IAM et administration > Quotas et limites du système :

   Accéder à la page Quotas et limites du système

2. Cliquez sur filter_listFiltrer pour filtrer les résultats par service.

3. Si la colonne Nom de la limite n'est pas visible, cliquez sur l'icône Options d'affichage des colonnes. Sélectionnez Nom de la limite, puis cliquez sur OK.

4. La colonne Nom de la limite indique l'ID de quota.

gcloud

Pour trouver la valeur de l'ID de quota à l'aide de gcloud CLI, exécutez la commande suivante pour lister les informations de quota pour le service spécifié :

1. Saisissez la commande gcloud CLI suivante dans une fenêtre de terminal :

   gcloud beta quotas info list --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
   --billing-project=BILLING_PROJECT_ID_OR_NUMBER
   

   Remplacez les éléments suivants :

   • SERVICE_NAME : nom du service avec les quotas que vous souhaitez afficher. Par exemple, le nom du service Compute Engine est compute.googleapis.com.

   • PROJECT_ID_OR_NUMBER : ID ou numéro du projet.

     Pour trouver l'ID de votre projet à l'aide de la console Google Cloud , accédez à la page "Gestionnaire de ressources" :

     Accédez au gestionnaire de ressources

   • BILLING_PROJECT_ID_OR_NUMBER : ID ou numéro du projet dont vous souhaitez utiliser le quota de l'API Cloud Quotas pour exécuter cette commande. Il peut être différent du projet contenant le service pour lequel vous recherchez l'ID de quota.

     Si vous avez déjà défini le projet de facturation lors de la configuration de gcloud CLI, ce flag est facultatif. Sinon, son omission peut entraîner une erreur d'autorisation refusée. Pour en savoir plus, consultez Définir le projet de quota.

2. La sortie de la commande gcloud beta quotas info list contient un texte semblable à l'exemple suivant :

   ...
   "quotaInfos": [
       ...
       {
           "name": "projects/PROJECT_NUMBER/locations/global/services/compute.googleapis.com/quotaInfos/CPUS-per-project-region",
           "quotaId": "CPUS-per-project-region",
           "metric": "compute.googleapis.com/cpus",
           "containerType": "PROJECT",
           "dimensions": [
               "region"
           ],
           "dimensionsInfo": [
               {
                   "details": {
                       "value": 20
                   },
                   "applicableLocations": [
                       "us-central1",
                       "us-central2",
                       "us-west1",
                       "us-east1"
                   ]
                   ...
               }
           ]
       },
       ...
   ]
   ...

3. Recherchez la valeur correspondant à quotaId et utilisez-la lorsque vous spécifiez QUOTA_ID dans les sections suivantes.

Exemples de commandes gcloud pour les informations sur les quotas

Cette section fournit des exemples qui montrent comment utiliser gcloud beta quotas info pour afficher les informations sur les quotas d'un service particulier ou d'une organisation.

QuotaInfo est une ressource en lecture seule qui fournit des informations sur les métadonnées et les valeurs de quota d'un quota particulier pour un projet, un dossier ou une organisation spécifique.

Afficher les informations sur les quotas d'un service particulier

Pour afficher les informations sur les quotas d'un service particulier, exécutez la commande suivante :

gcloud beta quotas info describe QUOTA_ID --service=SERVICE_NAME \
    --project=PROJECT_ID_OR_NUMBER --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Remplacez les éléments suivants :

• QUOTA_ID : valeur de l'ID de quota. Pour trouver cette valeur, consultez Trouver votre ID de quota.
• SERVICE_NAME : nom du service avec les quotas que vous souhaitez afficher. Par exemple, le nom du service Compute Engine est compute.googleapis.com.
• PROJECT_ID_OR_NUMBER : ID ou numéro du projet.

• BILLING_PROJECT_ID_OR_NUMBER : ID ou numéro du projet dont vous souhaitez utiliser le quota de l'API Cloud Quotas pour exécuter cette commande. Il peut être différent du projet contenant le service pour lequel vous consultez les informations sur le quota.

  Si vous avez déjà défini le projet de facturation lors de la configuration de gcloud CLI, ce flag est facultatif. Sinon, son omission peut entraîner une erreur d'autorisation refusée. Pour en savoir plus, consultez Définir le projet de quota.

Afficher les informations sur les quotas d'une organisation

Pour afficher les détails des quotas d'un même service pour une organisation, exécutez la commande suivante :

gcloud beta quotas info list --service=SERVICE_NAME --organization=ORGANIZATION_ID \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Remplacez les éléments suivants :

• SERVICE_NAME : nom du service avec les quotas que vous souhaitez afficher. Par exemple, le nom du service Compute Engine est compute.googleapis.com.
• ORGANIZATION_ID : ID de votre organisation.

• BILLING_PROJECT_ID_OR_NUMBER : ID ou numéro du projet dont vous souhaitez utiliser le quota de l'API Cloud Quotas pour exécuter cette commande. Il peut être différent du projet contenant le service pour lequel vous consultez les informations sur le quota.

  Si vous avez déjà défini le projet de facturation lors de la configuration de gcloud CLI, ce flag est facultatif. Sinon, son omission peut entraîner une erreur d'autorisation refusée. Pour en savoir plus, consultez Définir le projet de quota.

Exemples de commandes gcloud pour les préférences de quota

Cette section fournit des exemples qui montrent comment utiliser gcloud beta quotas preferences pour vérifier les préférences de quota existantes et ajuster la valeur du quota.

La ressource QuotaPreference représente vos préférences de quota pour une combinaison de dimension particulière. Une dimension est un attribut qui représente une région ou une zone, ou une dimension spécifique à un service, telle que gpu_family ou network_id.

Rechercher les préférences existantes

Pour vérifier les préférences existantes, exécutez la commande suivante :

gcloud beta quotas preferences list --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Remplacez les éléments suivants :

• PROJECT_ID_OR_NUMBER : ID ou numéro du projet.

• BILLING_PROJECT_ID_OR_NUMBER : ID ou numéro du projet dont vous souhaitez utiliser le quota de l'API Cloud Quotas pour exécuter cette commande. Il peut être différent du projet contenant le service pour lequel vous vérifiez les préférences de quota.

  Si vous avez déjà défini le projet de facturation lors de la configuration de gcloud CLI, ce flag est facultatif. Sinon, son omission peut entraîner une erreur d'autorisation refusée. Pour en savoir plus, consultez Définir le projet de quota.

Rechercher les préférences existantes avec des ajustements de quota en attente

Pour rechercher les préférences existantes avec des ajustements de quota en attente, ajoutez le flag --reconciling-only=true comme indiqué dans la commande suivante :

gcloud beta quotas preferences list --project=PROJECT_ID_OR_NUMBER --reconciling-only=true \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Remplacez les éléments suivants :

• PROJECT_ID_OR_NUMBER : ID ou numéro du projet.

• BILLING_PROJECT_ID_OR_NUMBER : ID ou numéro du projet dont vous souhaitez utiliser le quota de l'API Cloud Quotas pour exécuter cette commande. Il peut être différent du projet contenant le service pour lequel vous vérifiez les préférences de quota.

  Si vous avez déjà défini le projet de facturation lors de la configuration de gcloud CLI, ce flag est facultatif. Sinon, son omission peut entraîner une erreur d'autorisation refusée. Pour en savoir plus, consultez Définir le projet de quota.

Demander une augmentation de quota lorsque vous n'avez pas encore défini de préférence de quota

Pour demander un ajustement de quota à l'aide de gcloud CLI, exécutez la commande suivante :

gcloud beta quotas preferences create --project=PROJECT_ID_OR_NUMBER \
    --service=SERVICE_NAME \
    --quota-id=QUOTA_ID \
    --dimensions=DIMENSIONS \
    --preferred-value=PREFERRED_VALUE \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER \
    --email=EMAIL \
    --justification=JUSTIFICATION \
    --preference-id=PREFERENCE_ID

Remplacez les éléments suivants :

• PROJECT_ID_OR_NUMBER : ID ou numéro du projet.
• SERVICE_NAME : nom du service avec les quotas que vous souhaitez ajuster. Par exemple, le nom du service Compute Engine est compute.googleapis.com.
• QUOTA_ID : valeur de l'ID de quota. Pour trouver cette valeur, consultez Trouver votre ID de quota.
• DIMENSIONS : dimensions à ajuster, spécifiées sous la forme d'une liste de paires clé/valeur séparées par une virgule (par exemple, region=us-east4,gpu_family=NVIDIA_H100). Pour en savoir plus sur les dimensions de quota, consultez Configurer les dimensions des quotas Cloud.
• PREFERRED_VALUE : valeur de quota souhaitée.
• BILLING_PROJECT_ID_OR_NUMBER : ID ou numéro du projet dont vous souhaitez utiliser le quota de l'API Cloud Quotas pour exécuter cette commande. Il peut être différent du projet contenant le service pour lequel vous demandez un ajustement de quota.

  Si vous avez déjà défini le projet de facturation lors de la configuration de gcloud CLI, ce flag est facultatif. Sinon, son omission peut entraîner une erreur d'autorisation refusée. Pour en savoir plus, consultez Définir le projet de quota.

• EMAIL : adresse e-mail pouvant être utilisée comme contact, au cas où Google Cloud aurait besoin de plus d'informations avant d'accorder un quota supplémentaire.
• JUSTIFICATION : chaîne facultative expliquant votre requête.
• PREFERENCE_ID : ID de préférence facultatif. Si vous ne spécifiez pas d'ID de préférence, l'API génère un identifiant unique universel (UUID) automatiquement.

La sortie ressemble à ceci :

{
    "createTime":"CREATE_TIME",
    "dimensions":{
        "DIMENSION_KEY_1":"DIMENSION_VALUE_1",
        "DIMENSION_KEY_2":"DIMENSION_VALUE_2"
    },
    "etag":"ETAG_VALUE",
    "name":"projects/PROJECT_ID_OR_NUMBER/locations/global/quotaPreferences/PREFERENCE_ID",
    "quotaConfig":{
        "grantedValue":"GRANTED_VALUE",
        "preferredValue":"PREFERRED_VALUE",
        "traceId":"TRACE_ID"
    },
    "quotaId":"QUOTA_ID",
    "reconciling":true,
    "service":"SERVICE_NAME",
    "updateTime":"UPDATE_TIME",
}

Demander une augmentation de quota lorsque vous avez défini une préférence de quota

Pour demander une augmentation de quota pour une région spécifique et qu'il existe déjà une préférence, exécutez la commande suivante :

gcloud beta quotas preferences update PREFERENCE_ID --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER --email=EMAIL  \
    --justification=JUSTIFICATION

Remplacez les éléments suivants :

• PREFERENCE_ID : ID de préférence, qui est requis en tant que premier argument lorsque vous utilisez la commande gcloud beta quotas preferences update.
• PREFERRED_VALUE : valeur de quota souhaitée.
• QUOTA_ID : valeur de l'ID de quota. Pour trouver cette valeur, consultez Trouver votre ID de quota.
• SERVICE_NAME : nom du service avec les quotas que vous souhaitez afficher. Par exemple, le nom du service Compute Engine est compute.googleapis.com.
• PROJECT_ID_OR_NUMBER : ID ou numéro du projet.

• BILLING_PROJECT_ID_OR_NUMBER : ID ou numéro du projet dont vous souhaitez utiliser le quota de l'API Cloud Quotas pour exécuter cette commande. Il peut être différent du projet contenant le service pour lequel vous demandez un ajustement de quota.

  Si vous avez déjà défini le projet de facturation lors de la configuration de gcloud CLI, ce flag est facultatif. Sinon, son omission peut entraîner une erreur d'autorisation refusée. Pour en savoir plus, consultez Définir le projet de quota.

• EMAIL : adresse e-mail pouvant être utilisée comme contact, au cas où Google Cloud aurait besoin de plus d'informations avant d'accorder un quota supplémentaire.

• JUSTIFICATION : chaîne facultative expliquant votre requête.

Afficher une préférence de quota existante

Pour afficher les détails de la préférence de quota que vous venez de créer, exécutez la commande suivante :

gcloud beta quotas preferences describe PREFERENCE_ID \
    --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Remplacez les éléments suivants :

• PREFERENCE_ID : ID de préférence, qui est requis en tant que premier argument lorsque vous utilisez la commande gcloud beta quotas preferences describe.
• PROJECT_ID_OR_NUMBER : ID ou numéro du projet.

• BILLING_PROJECT_ID_OR_NUMBER : ID ou numéro du projet dont vous souhaitez utiliser le quota de l'API Cloud Quotas pour exécuter cette commande. Il peut être différent du projet contenant le service pour lequel vous consultez la préférence de quota.

  Si vous avez déjà défini le projet de facturation lors de la configuration de gcloud CLI, ce flag est facultatif. Sinon, son omission peut entraîner une erreur d'autorisation refusée. Pour en savoir plus, consultez Définir le projet de quota.

La sortie contient des données spécifiques à votre configuration et ressemble à l'exemple suivant :

createTime: 'CREATE_TIME'
dimensions:
  gpu_family: NVIDIA_H100
  region: us-east4
etag: ETAG_VALUE
name: projects/12345/locations/global/quotaPreferences/PREFERENCE_ID
quotaConfig:
  grantedValue: '0'
  preferredValue: '128'
  traceId: TRACE_ID
quotaId: GPUS-PER-GPU-FAMILY-per-project-region
reconciling: true
service: compute.googleapis.com
updateTime: 'UPDATE_TIME'

Activer l'outil d'ajustement de quota via un projet client

Un projet client fait référence au projet utilisé par une application ou un utilisateur pour accéder aux ressources Google Cloud et interagir avec elles, tandis qu'un projet de ressources est le projet sous-jacent dans lequel ces ressources sont stockées et gérées.

Pour activer l'outil d'ajustement des quotas dans un projet client à l'aide de gcloud CLI, procédez comme suit :

1. Créez un projet client :

   gcloud projects create CLIENT_PROJECT_ID
   gcloud config set project CLIENT_PROJECT_ID
   

   Remplacez CLIENT_PROJECT_ID par l'ID du projet que vous souhaitez créer. Les ID de projet sont immuables et ne peuvent être définis que lors de la création du projet. Ils doivent commencer par une lettre minuscule et peuvent comporter des lettres ASCII minuscules, des chiffres ou des traits d'union. L'ID du projet doit contenir entre 6 et 30 caractères.

2. Activez l'API Cloud Quotas sur le projet client :

   gcloud services enable cloudquotas.googleapis.com
   

3. Créez un compte de service dans le projet client :

   gcloud iam service-accounts create SA_NAME \
     --display-name SA_DISPLAY_NAME \
     --project=CLIENT_PROJECT_ID
   

   Remplacez les éléments suivants :

   • SA_NAME : nom interne du nouveau compte de service. Permet de générer un IAM_ACCOUNT (adresse e-mail interne IAM utilisée comme identifiant de compte de service), qui doit être transmis aux commandes suivantes.
   • SA_DISPLAY_NAME : nom à afficher du compte de service.
   • CLIENT_PROJECT_ID : ID du projet client.

4. Créez une clé de compte de service :

   gcloud iam service-accounts keys create KEY_FILE \
     --iam-account=SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com
   

   Remplacez les éléments suivants :

   • KEY_FILE : chemin d'accès au fichier de clé JSON du compte de service.
   • SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com : adresse e-mail du compte de service.

5. Accordez des autorisations IAM au compte de service :

   gcloud projects add-iam-policy-binding CLIENT_PROJECT_ID \
     --member="serviceAccount:SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com" \
     --role="roles/serviceusage.serviceUsageConsumer"
   
   gcloud projects add-iam-policy-binding RESOURCE_PROJECT_ID \
     --member="serviceAccount:SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com" \
     --role="roles/cloudquotas.admin"
   

   Remplacez les éléments suivants :

   • CLIENT_PROJECT_ID : ID du projet client.
   • RESOURCE_PROJECT_ID : ID du projet de ressource.
   • SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com : adresse e-mail du compte de service.

6. Activez le compte de service à l'aide de la clé de compte de service que vous avez créée précédemment :

   gcloud auth activate-service-account --key-file=KEY_FILE
   

7. Activez l'outil d'ajustement de quota sur votre projet de ressources en spécifiant le projet et le paramètre d'activation :

   gcloud beta quotas adjuster settings update --project=RESOURCE_PROJECT_ID \
     --enablement=enabled
   

   Le paramètre d'activation est obligatoire lorsque vous utilisez gcloud CLI et doit être défini sur enabled ou disabled.

8. (Facultatif) Pour afficher les paramètres actuels de l'outil d'ajustement de quota, exécutez la commande suivante :

   gcloud beta quotas adjuster settings describe --project=RESOURCE_PROJECT_ID 
   

   Le résultat ressemble à celui de l'exemple ci-dessous.

   enablement: ENABLED
   etag: 8izmJp6EI__mOfLyhkQU9
   name: projects/RESOURCE_PROJECT_ID/locations/global/quotaAdjusterSettings
   updateTime: '2025-01-10T17:22:37.883221181Z'
   

Pour activer l'outil d'ajustement de quota pour plusieurs projets clients, suivez les étapes 5 à 8 ci-dessus. Dans ce cas, assurez-vous que les conditions suivantes sont remplies :

• L'API Cloud Quotas est activée sur le projet client.
• Le compte de service dispose du rôle IAM cloudquotas.admin sur tous les projets de ressources pour lesquels vous souhaitez activer l'ajusteur de quota.

Autres services avec des commandes de la gcloud CLI liées aux quotas

En plus de gcloud beta quotas, certains services disposent de leur propre accès en ligne de commande aux informations sur l'utilisation des quotas et des ressources.

Par exemple, Compute Engine vous permet d'accéder aux informations sur les quotas. Pour en savoir plus, consultez les sections Compute Engine suivantes :

• Les quotas d'allocation
• Présentation de la gcloud CLI compute
• Section gcloud CLI compute de la documentation de référence du Google Cloud SDK

Étapes suivantes

• Pour résoudre les problèmes liés aux commandes gcloud beta quotas, consultez la section Résoudre les erreurs de gcloud CLI.

• Pour en savoir plus sur les commandes et les options gcloud beta quotas, consultez la section Quotas de gcloud beta de la documentation de référence de Google Cloud CLI.

• Pour en savoir plus sur la terminologie des quotas, consultez Comprendre la terminologie des quotas et des limites du système.