Modello quota di servizio

Questa pagina descrive il modello di gestione della quota per i servizi su Google Cloud. Comprendere questo modello di quota è utile quando utilizzi le funzionalità di gestione della quota di Service Usage. Per informazioni generali, consulta Utilizzo delle quote.

Un consumatore di un servizio è un progetto, una cartella o un'organizzazione a cui è attribuito l'utilizzo del servizio.

Metriche e limiti

Una metrica quota è un'entità definita da un servizio che tiene conto del consumo del servizio. Una metrica quota potrebbe conteggiare entità concrete come le istanze di macchine virtuali oppure entità temporanee come le richieste API di un tipo specifico.

Un limite di quota è un'entità definita da un servizio che specifica in che modo il consumo di una metrica della quota è limitato per un consumer. Una metrica quota può avere più limiti di quota. Esistono due tipi di limiti di quota: limiti di frequenza e limiti di allocazione. Un limite di frequenza viene reimpostato dopo un periodo di tempo specificato, ad esempio un minuto o un giorno. La quota di allocazione non viene reimpostata nel tempo, ma deve essere rilasciata esplicitamente quando una risorsa non viene più utilizzata.

Sostituzioni quota

Ogni limite di quota ha un valore predefinito per tutti i consumer, impostato dal proprietario del servizio. Questo valore predefinito può essere modificato tramite una sostituzione della quota.

Il proprietario del servizio può applicare un'override della quota a un consumer specifico per sostituire il valore predefinito per quel consumer. Questo si chiama sostituzione del produttore. Ad esempio, un proprietario di un servizio potrebbe applicare un'override del produttore per concedere una quota elevata a un cliente specifico nell'ambito di un contratto.

Il consumatore può applicare una sostituzione della quota al proprio progetto, alla propria cartella o alla propria organizzazione per limitare il proprio utilizzo di un servizio. Questo viene chiamato override del consumatore. Ad esempio, un consumatore potrebbe applicare un'override al proprio progetto come misura di controllo dei costi per evitare superamenti del budget.

Per applicare un'override del consumatore a un servizio che utilizzi, utilizza l'API Service Usage.

Per applicare un'override del produttore a un consumer di un servizio di tua proprietà, utilizza l'API Service Consumer Management.

Nota: per alcuni servizi, un amministratore delle quote può applicare un'override della quota speciale, chiamata override amministrativo, a un progetto all'interno di un'organizzazione che controlla. Un'override dell'amministratore sostituisce un override del producer o un limite predefinito.

Calcolo del limite di quota

La seguente formula calcola il limite di quota di un consumatore:

if adminOverride is present,
  upperBound = adminOverride
else if producerOverride is present,
  upperBound = producerOverride
else
  upperBound = defaultLimit

if consumerOverride is present,
  quotaLimit = min(consumerOverride, upperBound)
else
  quotaLimit = upperBound

Quota regionale e a livello di zona

Un limite di quota può essere conteggiato a livello globale o separatamente in ogni regione o zona Cloud.

Ad esempio, supponiamo che un servizio abbia un limite di quota globale di 100 richieste API al minuto. Se vengono effettuate 80 richieste API nella regione us-central1 e 70 richieste nella regione asia-northeast3, 150 richieste verranno conteggiate ai fini del limite globale e alcune richieste verranno rifiutate. Tuttavia, per un limite regionale, ogni regione ha una quota distinta di 100 richieste al minuto. 80 richieste in us-central1 non superano il limite di 100 richieste in quella regione, così come 70 richieste in asia-northeast3 non superano il limite di 100 richieste in quella regione, quindi nessuna richiesta verrà rifiutata.

Un'override della quota può essere applicata a tutte le regioni contemporaneamente o a una regione specifica. Quando viene applicata una sostituzione a una regione specifica, i limiti effettivi delle altre regioni rimangono invariati.

Analogamente, un'override della quota può essere applicata a tutte le zone contemporaneamente o a una zona specifica. Quando viene applicata una sostituzione a una zona specifica, i limiti effettivi delle altre zone rimangono invariati.