L'API Cloud Quotas représente les dimensions sous forme de paires clé/valeur. key
est le nom de la dimension (par exemple, region
). value
est 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 que vous possédez dans une région donnée.
Compute Engine dispose également de plusieurs dimensions d'attributs de produit, 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 console Google Cloud, à l'aide de Google Cloud CLI, en interrogeant l'API REST ou via des bibliothèques clientes. Pour afficher les dimensions pour lesquelles vous n'avez pas spécifié de valeur, utilisez gcloud CLI. Utilisez également gcloud CLI pour afficher les dimensions des quotas et des limites système qui n'ont pas de dimensions régionales ou 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
Accédez à la page 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.
Si vous ne voyez pas la colonne Dimensions, procédez comme suit : Sinon, ignorez cette étape.
- Cliquez sur Options d'affichage des colonnes.
- Sélectionnez des dimensions.
- Cliquez sur OK. La colonne Dimensions s'affiche dans le tableau.
Pour filtrer les résultats, saisissez un nom ou une valeur de propriété dans le champ situé à côté de
Filtrer.- Pour filtrer par produit, commencez à saisir le nom du produit, puis sélectionnez-le dans la liste qui s'affiche.
- Pour filtrer par dimension, saisissez votre dimension en utilisant le 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, saisissezregion: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 qui liste la valeur de quota ou de limite système par défaut à 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 dimensionregion
. 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 indiquée comme "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 pas associé à un attribut de région, de zone ou de produit. Il n'y a donc aucune dimension à afficher.
gcloud
Vous pouvez utiliser gcloud CLI pour afficher les dimensions d'un seul quota ou d'une seule limite système, ou de tous les quotas et limites système associés à un produit donné. Il est généralement plus rapide d'afficher les dimensions d'un seul quota ou d'une seule limite système que d'afficher les dimensions de 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 alpha 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 :- Pour le trouver, utilisez la console comme décrit dans la section Trouver votre ID de quota.
- Affichez toutes les dimensions du produit associé au quota ou à la limite 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
: l'ID de votre projet Google Cloud. Pour trouver votre ID de projet, choisissez l'une des options suivantes :- Pour trouver votre ID de projet à l'aide de la console, consultez la section Identifier des projets.
- 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 Compute Engine A2, l'ID de service estcompute.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 alpha quotas info list --project=PROJECT_ID --service=SERVICE_ID
Remplacez les éléments suivants :
PROJECT_ID
: l'ID de votre projet Google Cloud. Pour trouver votre ID de projet, choisissez l'une des options suivantes :- Pour trouver votre ID de projet à l'aide de la console, consultez la section Identifier des projets.
- 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 Compute Engine A2, l'ID de service estcompute.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 :
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.
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 :
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.
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.
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.
Si la configuration contient n'importe quelle dimension spécifique au service, elle doit contenir toutes les dimensions spécifiques au service.
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.