Afficher les quotas à l'aide de la CLI gcloud alpha

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

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

Limites

Cloud Quotas présente les limites suivantes :

Toutes les augmentations de quota sont soumises à l'approbation de Google Cloud.
Vous pouvez demander des ajustements d'augmentation ou de diminution du quota pour les quotas au niveau du projet.
Vous pouvez demander des ajustements de diminution de quota pour les quotas au niveau du projet, du dossier, et de l'organisation.

Avant de commencer

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

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

Installer et initialiser gcloud CLI

Pour utiliser la gcloud CLI, assurez-vous d'avoir installé et initialisé la dernière version de la gcloud CLI, y compris les commandes alpha. Si vous utilisez Cloud Shell pour interagir avec Google Cloud, la Google Cloud CLI est installée automatiquement.

Trouver votre ID de quota

De nombreuses commandes de la gcloud CLI sur cette page font référence à votre ID de quota.

Pour trouver la valeur de l'ID de quota, utilisez la commande de la gcloud CLI suivante pour listez les informations de quota pour le service spécifié :

Saisissez la commande gcloud CLI suivante dans une fenêtre de terminal :
```
gcloud alpha quotas info list --service=SERVICE_NAME --project=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 Cloud Logging est logging.googleapis.com.
- PROJECT_ID_OR_NUMBER : ID ou numéro de projet
  
  Pour trouver l'ID de votre projet à l'aide de la console Google Cloud, accédez à la page de Resource Manager :
  
  Accédez au gestionnaire de ressources

La sortie de la commande gcloud alpha 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"
                ]
                ...
            }
        ]
    },
    ...
]
...

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

Exemples de commandes d'informations sur le quota gcloud

Cette section fournit des exemples qui montrent comment utiliser gcloud alpha 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 le quota d'un service spécifique

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

gcloud alpha quotas info describe QUOTA_ID --service=SERVICE_NAME \
    --project=PROJECT_ID_OR_NUMBER

Remplacez les éléments suivants :

QUOTA_ID : ID du quota
SERVICE_NAME : nom du service avec les quotas que vous souhaitez afficher. Par exemple, le nom du service Cloud Logging est logging.googleapis.com.
PROJECT_ID_OR_NUMBER : ID ou numéro du projet

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 alpha quotas info list --service=SERVICE_NAME --organization=ORGANIZATION_ID

Remplacez les éléments suivants :

SERVICE_NAME : nom du service avec les quotas que vous souhaitez afficher. Par exemple, le nom du service Cloud Logging est logging.googleapis.com.
ORGANIZATION_ID : ID de votre organisation.

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

Cette section fournit des exemples qui montrent comment utiliser gcloud alpha 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 propre à un service, telle que gpu_family ou network_id.

Rechercher des préférences existantes

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

gcloud alpha quotas preferences list --project=PROJECT_ID_OR_NUMBER

Remplacez PROJECT_ID_OR_NUMBER par l'ID ou le numéro du projet.

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 l'option --reconciling-only=true comme indiqué dans la commande suivante :

gcloud alpha quotas preferences list --project=PROJECT_ID_OR_NUMBER --reconciling-only=true

Remplacez PROJECT_ID_OR_NUMBER par l'ID ou le numéro du projet.

Demander un ajustement d'augmentation de quota pour une région spécifique lorsqu'aucune préférence de quota n'a été définie

Pour demander une augmentation de quota pour une région spécifique lorsqu'aucune préférence n'a encore été définie, exécutez la commande suivante :

gcloud alpha quotas preferences create --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME \
    --project=PROJECT_ID_OR_NUMBER --preference-id=PREFERENCE_ID

Remplacez les éléments suivants :

PREFERRED_VALUE : valeur de quota préférée
QUOTA_ID : ID du quota
SERVICE_NAME : nom du service avec les quotas que vous souhaitez afficher. Par exemple, le nom du service Cloud Logging est logging.googleapis.com.
PROJECT_ID_OR_NUMBER : ID ou numéro du projet
PREFERENCE_ID : ID de préférence

Demander un ajustement d'augmentation de quota pour une région spécifique lorsqu'une préférence de quota a été définie

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

gcloud alpha quotas preferences update PREFERENCE_ID --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME--project=PROJECT_ID_OR_NUMBER

Remplacez les éléments suivants :

PREFERENCE_ID : ID de préférence
PREFERRED_VALUE</var>"}} : valeur de quota souhaitée
QUOTA_ID : ID du quota
SERVICE_NAME : nom du service avec les quotas que vous souhaitez afficher. Par exemple, le nom du service Cloud Logging est logging.googleapis.com.
PROJECT_ID_OR_NUMBER : ID ou numéro du projet

Récupérer une préférence de quota existante

Pour récupérer une préférence de quota existante, exécutez la commande suivante :

gcloud alpha quotas preferences describe PREFERENCE_ID project=PROJECT_ID_OR_NUMBER

Remplacez les éléments suivants :

PREFERENCE_ID : ID de préférence
PROJECT_ID_OR_NUMBER : ID ou numéro du projet

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

En plus de gcloud alpha 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 SDK Google Cloud

Étapes suivantes

Pour obtenir la liste complète des commandes et des options gcloud alpha quotas, consultez la section Quotas alpha de la gcloud de la documentation de référence de la Google Cloud CLI.

Pour en savoir plus sur la terminologie des quotas, consultez Comprendre les valeurs de quota et les limites du système.