QuotaFailure

Décrit comment une vérification de quota a échoué.

Par exemple, si une limite quotidienne a été dépassée pour le projet appelant, un service peut répondre avec un détail QuotaFailure contenant l'ID du projet et la description de la limite de quota qui a été dépassée. Si le projet appelant n'a pas activé le service dans la console de développement, un service peut répondre avec l'ID du projet et définir service_disabled sur "true".

Consultez également les types RetryInfo et Help pour en savoir plus sur la gestion des échecs de quota.

Représentation JSON 
{
  "violations": [
    {
      object (Violation)
    }
  ]
}
Champs
violations[]

object (Violation)

Décrit toutes les violations de quota.

Infraction

Type de message utilisé pour décrire un seul cas de non-respect du quota. (par exemple, un quota quotidien ou personnalisé qui a été dépassé).

Représentation JSON 
{
  "subject": string,
  "description": string,
  "apiService": string,
  "quotaMetric": string,
  "quotaId": string,
  "quotaDimensions": {
    string: string,
    ...
  },
  "quotaValue": string,
  "futureQuotaValue": string
}
Champs
subject

string

Sujet pour lequel la vérification du quota a échoué. Par exemple, "clientip:" ou "project:".
description

string

Description de l'échec de la vérification du quota. Les clients peuvent utiliser cette description pour en savoir plus sur la configuration des quotas dans la documentation publique du service ou trouver la limite de quota appropriée à ajuster dans la console de développement.

Par exemple : "Service désactivé" ou "Limite quotidienne pour les opérations de lecture dépassée".
apiService

string

Service API à partir duquel provient QuotaFailure.Violation. Dans certains cas, les problèmes de quota proviennent d'un service d'API autre que celui qui a été appelé. En d'autres termes, une dépendance du service d'API appelé peut être à l'origine de l'erreur QuotaFailure. Dans ce cas, le nom du service d'API de dépendance est indiqué dans ce champ.

Par exemple, si l'API appelée est l'API Kubernetes Engine (container.googleapis.com) et qu'un dépassement de quota se produit dans l'API Kubernetes Engine elle-même, ce champ sera "container.googleapis.com". En revanche, si le dépassement de quota se produit lorsque l'API Kubernetes Engine crée des VM dans l'API Compute Engine (compute.googleapis.com), ce champ sera "compute.googleapis.com".
quotaMetric

string

Métrique du quota enfreint. Une métrique de quota est un compteur nommé permettant de mesurer l'utilisation, comme les requêtes API ou les processeurs. Lorsqu'une activité se produit dans un service, comme l'allocation de machines virtuelles, une ou plusieurs métriques de quota peuvent être affectées.

Par exemple, "compute.googleapis.com/cpus_per_vm_family", "storage.googleapis.com/internet_egress_bandwidth".
quotaId

string

ID du quota enfreint. Également appelé "nom de la limite", il s'agit de l'identifiant unique d'un quota dans le contexte d'un service d'API.

Par exemple, "CPUS-PER-VM-FAMILY-per-project-region".
quotaDimensions

map (key: string, value: string)

Dimensions du quota enfreint. Chaque quota non global est appliqué à un ensemble de dimensions. Alors que la métrique de quota définit ce qu'il faut comptabiliser, les dimensions spécifient les aspects pour lesquels le compteur doit être incrémenté.

Par exemple, le quota "Processeurs par région et par famille de VM" applique une limite à la métrique "compute.googleapis.com/cpus_per_vm_family" sur les dimensions "region" et "vm_family". Si le non-respect a eu lieu dans la région "us-central1" et pour la famille de VM "n1", quotaDimensions serait,

{ "region": "us-central1", "vm_family": "n1", }

Lorsqu'un quota est appliqué au niveau mondial, quotaDimensions est toujours vide.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
quotaValue

string (int64 format)

Valeur du quota appliqué au moment de l'QuotaFailure.

Par exemple, si la valeur du quota appliqué au moment de l'QuotaFailure sur le nombre de processeurs est "10", la valeur de ce champ reflète cette quantité.
futureQuotaValue

string (int64 format)

La nouvelle valeur de quota déployée au moment de l'infraction. Une fois le déploiement terminé, cette valeur sera appliquée à la place de quotaValue. Si aucun déploiement n'est en cours au moment de l'infraction, ce champ n'est pas défini.

Par exemple, si au moment de l'infraction, un déploiement est en cours pour modifier le quota de nombre de processeurs de 10 à 20, la valeur de ce champ sera de 20.