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'état413 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 valeur403 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 :
Installez gcloud CLI.
Si vous utilisez Cloud Shell, vous pouvez ignorer cette étape, car gcloud CLI est préinstallé.
Initialisez gcloud CLI.
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 :
- Définir le projet de quota de manière automatisée
- Définir le projet de facturation via la gcloud CLI
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.