Configurer les dimensions Cloud Quotas

Les dimensions Cloud Quotas représentent différentes manières de mesurer l'utilisation des ressources dans Google Cloud. Les dimensions sont généralement un attribut de région, de zone, Google Cloud d'utilisateur ou de produit.

L'API Cloud Quotas représente les dimensions sous forme de paires clé/valeur. key correspond au nom de la dimension (par exemple, region). value correspond à la valeur attribuée à la dimension (par exemple, une région telle que us-central1).

Par exemple, Compute Engine mesure l'utilisation des VM à l'aide de différentes dimensions. La dimension region mesure le nombre de VM dont vous disposez dans une région donnée. Compute Engine dispose également de plusieurs dimensions d'attributs de produits, y compris gpu_family. La dimension gpu_family mesure le nombre de GPU d'une famille donnée dans votre projet Google Cloud .

Afficher les dimensions

Vous pouvez afficher les dimensions des quotas et des limites système dans la consoleGoogle Cloud , à l'aide de la Google Cloud CLI, en interrogeant l'API REST ou via les bibliothèques clientes. Pour afficher les dimensions pour lesquelles vous n'avez pas spécifié de valeur, utilisez la gcloud CLI. Utilisez également la gcloud CLI pour afficher les dimensions des quotas et des limites système qui n'ont pas de dimensions régionales ni zonales si votre projet n'utilise pas déjà la ressource associée. Cette section explique comment afficher les dimensions à l'aide de la console et 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

   Le tableau de cette page affiche les dimensions dans la colonne Dimensions.

2. Si la colonne Dimensions n'apparaît pas, procédez comme suit. Sinon, ignorez cette étape.

   1. Cliquez sur Options d'affichage des colonnes.
   2. Sélectionnez des dimensions.
   3. Cliquez sur OK. La colonne Dimensions s'affiche dans le tableau.

3. Pour filtrer les résultats, saisissez un nom ou une valeur de propriété dans le champ à côté de filter_list Filtrer.

   • Pour filtrer par produit, commencez à saisir son nom, puis sélectionnez-le dans la liste qui s'affiche.
   • Pour filtrer par dimension, saisissez votre dimension au format suivant : dimension_name:dimension_value. Par exemple, pour afficher les quotas et les limites système définis pour la région us-central1, saisissez region:us-central.

Comprendre les dimensions vides

Il arrive que la colonne Dimensions soit vide. Cette situation peut se produire pour les raisons suivantes :

• La valeur de quota ou de limite système est la valeur par défaut et s'applique à toutes les dimensions. Pour certains quotas et limites système, la console affiche une ligne indiquant la valeur par défaut du quota ou de la limite système à titre de référence. Étant donné que la valeur par défaut s'applique à toutes les valeurs de dimension, la colonne Dimensions est vide. Pour identifier ces entrées, examinez la colonne Nom. La colonne Nom indique ces entrées avec le mot "par défaut" entre parenthèses à la fin du nom du quota ou de la limite système.

  Par exemple, le quota SetIamPolicyRequestsPerMinutePerProject est défini sur la dimension region. La console affiche une entrée de référence et une entrée pour chaque région. Dans la colonne Nom, l'entrée de référence est listée sous le nom "Requêtes SetIAMPolicy par minute et par région (par défaut)". Pour cette entrée, la colonne Dimensions est vide.

• Aucune dimension ne s'applique. Par exemple, le quota Compute Engine NETWORKS-per-project n'est associé à aucun attribut de région, de zone ou de produit. Il n'y a donc aucune dimension à afficher.

gcloud

Preview — gcloud CLI for Cloud Quotas

Cette fonctionnalité est soumise(s) aux "Conditions des offres de pré-DG" de la section "Conditions générales des Services" 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.

Vous pouvez utiliser la gcloud CLI pour afficher les dimensions d'un seul quota ou d'une seule limite système, ou pour tous les quotas et limites système associés à un produit donné. Afficher les dimensions pour un seul quota ou une seule limite système est généralement plus rapide que d'afficher les dimensions pour tous les quotas et limites système associés à un produit. En règle générale, la réponse à une requête pour un seul quota contient environ 200 lignes. La réponse à une requête pour un produit peut dépasser 2 000 lignes.

Afficher les dimensions d'un seul quota ou d'une seule limite système avec gcloud

Pour afficher les dimensions d'un seul quota ou d'une seule limite système à l'aide de gcloud CLI, exécutez la commande suivante dans votre terminal :

gcloud beta quotas info describe QUOTA_ID --project=PROJECT_ID --service=SERVICE_ID

Remplacez les éléments suivants :

• QUOTA_ID : ID du quota ou de la limite système. Si vous ne connaissez pas votre ID de quota, choisissez l'une des options suivantes :

  1. Pour le trouver à l'aide de la console, consultez Trouver votre ID de quota.
  2. Affichez toutes les dimensions du produit associé au quota ou à la limite du système qui vous intéresse. Cette commande ne nécessite pas l'ID de quota. Consultez la section Afficher les dimensions d'un produit avec gcloud CLI.

• PROJECT_ID : ID de votre projet Google Cloud. Pour trouver votre ID de projet, choisissez l'une des options suivantes :

  1. Pour trouver votre ID de projet à l'aide de la console, consultez la section Identifier des projets.
  2. Si vous avez défini votre projet actuel comme projet par défaut dans la configuration de gcloud CLI, recherchez l'ID de votre projet en exécutant la commande gcloud suivante dans votre terminal :

     gcloud config get-value project

• SERVICE_ID : ID de service du produit associé au quota ou à la limite du système. Par exemple, si le quota concerne les processeurs A2 de Compute Engine, l'ID de service est compute.googleapis.com.

Afficher les dimensions d'un produit avec gcloud CLI

Pour afficher les dimensions d'un seul quota ou d'une seule limite système à l'aide de gcloud CLI, exécutez la commande suivante dans votre terminal :

gcloud beta quotas info list --project=PROJECT_ID --service=SERVICE_ID

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud. Pour trouver votre ID de projet, choisissez l'une des options suivantes :

  1. Pour trouver votre ID de projet à l'aide de la console, consultez la section Identifier des projets.
  2. Si vous avez défini votre projet actuel comme projet par défaut dans la configuration de gcloud CLI, recherchez l'ID de votre projet en exécutant la commande gcloud suivante dans votre terminal :

     gcloud config get-value project

• SERVICE_ID : ID de service du produit associé au quota ou à la limite du système. Par exemple, si le quota concerne les processeurs A2 de Compute Engine, l'ID de service est compute.googleapis.com.

Priorité des dimensions

Certains cas d'utilisation de l'API Cloud Quotas présentent des configurations de dimensions complexes. Les quotas peuvent être configurés de manière plus précise que les seules régions et zones. Vous pouvez effectuer cette opération lorsque vous utilisez des dimensions spécifiques au service. Par exemple, gpu_family et network_id sont des dimensions spécifiques au service dans le service Compute Engine. Les dimensions sont définies par chaque service, et chaque service peut avoir un ensemble différent de dimensions spécifiques à un service.

Lorsque vous utilisez des dimensions de zone géographique ou des dimensions spécifiques à un service, la priorité suivante est appliquée :

1. Une configuration de préférence de quota avec toutes les dimensions d'emplacement et spécifiques au service est prioritaire sur toute autre configuration.

2. Les configurations qui spécifient des dimensions d'emplacement ont la priorité sur les configurations ne contenant que des dimensions spécifiques au service.

Combiner des dimensions

Dans une configuration de préférence de quota, vous pouvez combiner les dimensions de différentes manières :

1. La configuration peut contenir à la fois des dimensions d'emplacement et des dimensions spécifiques au service. Il s'agit de l'ordre décroissant.

2. La configuration ne peut contenir que des dimensions d'emplacement. Cette configuration s'applique à toutes les dimensions spécifiques au service, à l'exception de celles configurées explicitement à l'aide de la méthode 1.

3. La configuration peut contenir uniquement des dimensions spécifiques au service. Cette configuration s'applique à tous les emplacements, à l'exception de ceux explicitement configurés avec la méthode 1 ou 2.

4. Si la configuration contient n'importe quelle dimension spécifique au service, elle doit contenir toutes les dimensions spécifiques au service.

5. Vous pouvez disposer de configurations sans aucune dimension. Ces configurations s'appliquent à tous les emplacements et à toutes les dimensions spécifiques au service, à l'exception de celles explicitement configurées.