QuotaFailure

Descrive il motivo per cui un controllo della quota non è riuscito.

Ad esempio, se un limite giornaliero è stato superato per il progetto chiamante, un servizio potrebbe rispondere con un dettaglio QuotaFailure contenente l'ID progetto e la descrizione del limite di quota superato. Se il progetto chiamante non ha attivato il servizio nella console per gli sviluppatori, un servizio potrebbe rispondere con l'ID progetto e impostare service_disabled su true.

Consulta anche i tipi RetryInfo e Help per altri dettagli sulla gestione di un errore di quota.

Rappresentazione JSON 
{
  "violations": [
    {
      object (Violation)
    }
  ]
}
Campi
violations[]

object (Violation)

Descrive tutte le violazioni delle quote.

Violazione

Un tipo di messaggio utilizzato per descrivere una singola violazione della quota. Ad esempio, una quota giornaliera o una quota personalizzata che è stata superata.

Rappresentazione JSON 
{
  "subject": string,
  "description": string,
  "apiService": string,
  "quotaMetric": string,
  "quotaId": string,
  "quotaDimensions": {
    string: string,
    ...
  },
  "quotaValue": string,
  "futureQuotaValue": string
}
Campi
subject

string

Il soggetto per cui il controllo della quota non è riuscito. Ad esempio, "clientip:" o "project:".
description

string

Una descrizione del motivo per cui il controllo della quota non è riuscito. I clienti possono utilizzare questa descrizione per scoprire di più sulla configurazione delle quote nella documentazione pubblica del servizio o trovare il limite di quota pertinente da modificare tramite la console per gli sviluppatori.

Ad esempio: "Servizio disattivato" o "Limite giornaliero per le operazioni di lettura superato".
apiService

string

Il servizio API da cui ha origine QuotaFailure.Violation. In alcuni casi, i problemi relativi alla quota hanno origine da un servizio API diverso da quello chiamato. In altre parole, una dipendenza del servizio API chiamato potrebbe essere la causa di QuotaFailure e questo campo conterrebbe il nome del servizio API di dipendenza.

Ad esempio, se l'API chiamata è l'API Kubernetes Engine (container.googleapis.com) e si verifica una violazione della quota nell'API Kubernetes Engine stessa, questo campo sarà "container.googleapis.com". D'altra parte, se la violazione della quota si verifica quando l'API Kubernetes Engine crea VM nell'API Compute Engine (compute.googleapis.com), questo campo sarà "compute.googleapis.com".
quotaMetric

string

La metrica della quota violata. Una metrica di quota è un contatore denominato per misurare l'utilizzo, ad esempio le richieste API o le CPU. Quando si verifica un'attività in un servizio, ad esempio l'allocazione di una macchina virtuale, una o più metriche di quota potrebbero essere interessate.

Ad esempio, "compute.googleapis.com/cpus_per_vm_family", "storage.googleapis.com/internet_egress_bandwidth".
quotaId

string

L'ID della quota violata. Noto anche come "nome limite", è l'identificatore univoco di una quota nel contesto di un servizio API.

Ad esempio, "CPUS-PER-VM-FAMILY-per-project-region".
quotaDimensions

map (key: string, value: string)

Le dimensioni della quota violata. Ogni quota non globale viene applicata a un insieme di dimensioni. Mentre la metrica quota definisce cosa conteggiare, le dimensioni specificano per quali aspetti deve essere incrementato il contatore.

Ad esempio, la quota "CPU per regione per famiglia di VM" impone un limite alla metrica "compute.googleapis.com/cpus_per_vm_family" per le dimensioni "region" e "vm_family". Se la violazione si è verificata nella regione "us-central1" e per la famiglia di VM "n1", quotaDimensions sarebbe:

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

Quando una quota viene applicata a livello globale, quotaDimensions è sempre vuoto.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
quotaValue

string (int64 format)

Il valore della quota applicata al momento del QuotaFailure.

Ad esempio, se il valore della quota applicata al momento di QuotaFailure sul numero di CPU è "10", il valore di questo campo rifletterà questa quantità.
futureQuotaValue

string (int64 format)

Il nuovo valore della quota in fase di implementazione al momento della violazione. Al termine dell'implementazione, questo valore verrà applicato al posto di quotaValue. Se al momento della violazione non è in corso alcuna implementazione, questo campo non viene impostato.

Ad esempio, se al momento della violazione è in corso un'implementazione che modifica la quota del numero di CPU da 10 a 20, 20 sarà il valore di questo campo.