Résoudre les erreurs de quota

Vous pouvez recevoir des erreurs de quota pour plusieurs raisons, par exemple si vous dépassez les valeurs de quota ou si vous ne définissez pas correctement le quota d'un projet. Si vous souhaitez être averti en cas d'erreur, vous pouvez créer des alertes personnalisées pour des erreurs de quota spécifiques, comme décrit dans la section Configurer des alertes de quota.

Dépassement des quotas de débit

Les quotas de débit sont réinitialisés après un intervalle prédéfini spécifique à chaque service. Pour en savoir plus, consultez la documentation sur les quotas d'un service spécifique.

Dépassement des valeurs de quota

Si votre projet dépasse sa valeur de quota maximale lors de l'utilisation d'un service, Google Cloud renvoie une erreur en fonction de la manière dont vous avez accédé au service :

  • Si vous dépassez une valeur de quota avec une requête API, Google Cloud renvoie un code d'état HTTP 413 REQUEST ENTITY TOO LARGE. Notez que lorsque vous utilisez l'ancienne API de diffusion BigQuery dans un environnement de production, vous pouvez recevoir un code d'état 413 REQUEST ENTITY TOO LARGE si vos requêtes HTTP dépassent 10 Mo. Vous pouvez également recevoir cette erreur si vous dépassez 300 Mo par seconde. Pour en savoir plus, consultez la page Insertions en flux continu.
  • Si vous avez dépassé une valeur de quota avec une requête HTTP/REST, Google Cloud renvoie un code d'état HTTP 429 TOO MANY REQUESTS.
  • Si vous dépassez un quota pour Compute Engine, Google Cloud renvoie généralement un code d'état HTTP 403 QUOTA_EXCEEDED, qu'il s'agisse d'une API, de HTTP/REST ou de gRPC. Si le quota est un quota de débit, la valeur 403 RATE_LIMIT_EXCEEDED est renvoyée.
  • Si vous avez dépassé une valeur de quota avec gRPC, Google Cloud renvoie une erreur ResourceExhausted. La manière dont cette erreur s'affiche dépend du service.
  • Si vous avez dépassé une valeur de quota avec une commande Google Cloud CLI, gcloud CLI génère un message d'erreur de dépassement de quota, puis affiche le code de sortie 1.
  • Si vous avez reçu un message QUOTA_EXCEEDED lors du déploiement d'un service, consultez la section suivante.

Dépassement des valeurs de quota lors d'un déploiement de service

Google Cloud modifie parfois les valeurs de quota par défaut pour les ressources et les API. Ces modifications ont lieu progressivement, ce qui signifie que lors du déploiement d'un nouveau quota par défaut, la valeur de quota qui s'affiche dans la console Google Cloud ne reflète peut-être pas la nouvelle valeur de quota disponible.

Si un déploiement de quota est en cours, vous pouvez recevoir un message d'erreur indiquant The future limit is the new default quota that will be available after a service rollout completes.. Si ce message d'erreur s'affiche, la valeur du quota cité et la valeur future sont correctes, même si ce qui s'affiche dans la console Google Cloud est différent.

  • Pour en savoir plus, consultez les journaux d'audit et recherchez un message QUOTA_EXCEEDED.

        "status": {
          ...
          "message": "QUOTA_EXCEEDED",
          "details": [
            {
              ...
              "value": {
                "quotaExceeded": {
                  ...
                  "futureLimit": FUTUREVALUE
                }
              }
            }
          ]
        },
    
  • Pour afficher des graphiques indiquant l'utilisation actuelle et maximale, accédez à la page Quotas et limites du système, puis cliquez sur Surveillance. Vous devrez peut-être aller à la fin du tableau.

  • Si vous avez besoin d'un quota plus élevé, vous pouvez demander un ajustement de quota.

Messages d'erreur de l'API

Si votre projet de quota (également appelé projet de facturation) n'est pas correctement défini, les requêtes API peuvent renvoyer des messages d'erreur semblables à ceux-ci :

  • User credentials not supported by this API
  • API not enabled in the project
  • No quota project set

Ces erreurs et d'autres peuvent souvent être corrigées en définissant le projet de quota. Pour en savoir plus, consultez la page Présentation des projets de quota.

Erreurs de Google Cloud CLI

Cette section décrit les problèmes courants rencontrés lors de l'utilisation de Google Cloud CLI (gcloud CLI).

Installation et initialisation

Pour utiliser gcloud CLI pour les quotas cloud, assurez-vous d'installer et d'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 alpha en exécutant la commande suivante :

    gcloud components install alpha
    

Définir votre projet de quota

Si vous n'avez pas défini votre projet de quota, les commandes gcloud CLI peuvent renvoyer une erreur semblable à la suivante :

PERMISSION_DENIED: Your application is authenticating by using local Application Default Credentials.
The cloudquotas.googleapis.com API requires a quota project, which is not set by default.

Pour résoudre ce problème, ajoutez l'option --billing-project à votre commande gcloud CLI afin de définir explicitement le projet de quota, ou exécutez à nouveau gcloud config set billing/quota_project CURRENT_PROJECT pour définir le projet de quota comme projet actuel.

Pour en savoir plus, consultez les ressources suivantes :

Mettre à jour les composants de gcloud CLI

Si vous recevez une erreur indiquant que la commande quotas contient un Invalid choice, il est possible qu'une ancienne version de gcloud CLI soit installée. Mettez à jour gcloud CLI à l'aide de la commande suivante :

gcloud components update

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