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 la gcloud CLI

Si vous n'avez pas défini votre projet de quota, les commandes de la Google Cloud CLI (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 :