Visualizzare e gestire le quote

Questa pagina descrive come visualizzare i valori delle quote nella console Google Cloud. Puoi anche gestire la quota dalla console Google Cloud, dall'API Cloud Quotas e da Google Cloud CLI (gcloud CLI).

Limitazioni

Le quote Cloud presentano le seguenti limitazioni:

  • Nella maggior parte dei casi, gli aggiustamenti per l'aumento della quota devono essere apportati a livello di progetto. Un numero limitato di prodotti supporta gli aggiustamenti dell'aumento della quota a livello di organizzazione. Per sapere se un prodotto Google Cloud supporta gli aggiustamenti dell'aumento della quota a livello di organizzazione, consulta la documentazione relativa al prodotto.

  • Puoi richiedere aggiustamenti di riduzione delle quote per le quote a livello di progetto, organizzazione e cartella.

  • L'API Cloud Quotas supporta solo le operazioni a livello di progetto. Le operazioni a livello di cartella e di organizzazione non sono supportate.

  • Nella console Google Cloud, la pagina Quote e limiti di sistema non supporta la selezione di regioni o zone per le richieste di aggiustamento delle quote dal pulsante Modifica. Per modificare le quote a livello regionale o zonale nella console Google Cloud, consulta le istruzioni su come richiedere una quota più alta.

Visualizzare le quote nella console Google Cloud

Puoi visualizzare i valori di quota attuali in due aree diverse della console Google Cloud:

Visualizza le quote per il tuo progetto

La pagina Quote e Limiti di sistema mostra una tabella con colonne configurabili. Le colonne Servizio e Quota forniscono informazioni generali sulla quota descritta. Ad esempio, Servizio potrebbe essere API Cloud Logging e Quota potrebbe essere Richieste di importazione dei log al minuto. Il campo Quota descrive anche come viene valutata la quota. Le quote di frequenza vengono valutate al minuto, per 100 secondi o per giorno. Le quote senza nessuna di queste istruzioni sono quote di allocazione.

Per visualizzare l'utilizzo e i valori delle quote per tutte le risorse del tuo progetto, segui questi passaggi:

  1. Vai alla pagina Quote e Limiti di sistema:

    Vai a Quote e Limiti di sistema

  2. Per concentrarti sulle informazioni di cui hai bisogno, filtra e ordina l'elenco come segue:

    • Per filtrare l'elenco, inserisci le proprietà e i valori nel campo Filtro. Ad esempio, per visualizzare le quote dell'API BigQuery, seleziona Servizio, quindi API BigQuery.

    • Per ordinare l'elenco, fai clic sull'intestazione della colonna in base alla quale farlo. Ad esempio, per ordinare in ordine alfabetico in base al nome della quota, fai clic sull'intestazione della colonna Quota.

    Per impostazione predefinita, l'elenco è ordinato in modo da mostrare innanzitutto le quote più utilizzate, permettendoti di individuare le quote che rischiano di essere superate.

  3. (Facoltativo) Per esaminare l'utilizzo aggregato della quota a livello di cartella e a livelli di organizzazione, seleziona l'organizzazione o la cartella dalla risorsa selettore.

Puoi trovare ulteriori informazioni sulla quota utilizzando le colonne Metrica, Nome limite e Risorsa monitorata. Queste colonne forniscono le informazioni dettagliate necessarie per creare un grafico di una quota.

Per informazioni sull'utilizzo delle quote, visualizza le colonne Percentuale di utilizzo attuale e Utilizzo attuale. L'utilizzo corrente viene calcolato in base ai seguenti criteri:

  • Per le quote per tariffa al minuto:

    • L'utilizzo medio al minuto negli ultimi 10 minuti.

  • Per le quote con tariffa giornaliera:

    • L'utilizzo totale fino al momento attuale nella giornata corrente, in base al fuso orario del Pacifico.

  • Per le quote di allocazione:

    • Il valore più recente. Ad esempio, questo numero potrebbe indicare il numero di bilanciatori del carico in uso nel progetto.

  • Per le quote concorrenti:

    • Il valore più recente. Ad esempio, questo numero potrebbe indicare il numero di insert_operations in corso per un determinato servizio.

Per visualizzare un grafico sull'utilizzo, fai clic su Mostra grafico sull'utilizzo.

Per scoprire di più sulle quote per un servizio specifico, consulta la documentazione relativa al servizio. Ad esempio, la quota di Compute Engine è documentata in Quote delle risorse.

Visualizzare la quota specifica dell'API

Per visualizzare informazioni dettagliate sulla quota di un'API specifica, compreso l'utilizzo nel tempo, visita la pagina della quota dell'API nella console Google Cloud. A seconda dell'API, questi limiti possono includere richieste al giorno, richieste al minuto e richieste al minuto per utente. Per alcune API i limiti impostati sono estremamente bassi fino a che non abiliti la fatturazione nel progetto.

Puoi visualizzare i limiti attuali per una determinata API in due diverse aree della console Google Cloud:

  • Nella pagina Quote e limiti di sistema della console Google Cloud.

  • Nella pagina Dashboard API e servizi della console Google Cloud. In questa pagina, seleziona il tuo progetto, fai clic sul nome dell'API e poi su Quote. La pagina Quote e Limiti di sistema mostra i nomi delle quote per l'API. Fai clic su Visualizza grafico di utilizzo per ogni quota per visualizzare l'utilizzo dettagliato nel tempo. I valori visualizzati sono i valori predefiniti della quota, a meno che non sia stato apportato un aggiustamento della quota.

    Puoi limitare l'utilizzo, noto anche come sostituzione della quota, come descritto nella sezione Creare una sostituzione della quota. Se per una determinata quota non è presente un valore, viene visualizzato il valore Nessun limite.

Filtra quote

Per filtrare l'elenco delle quote in base a proprietà specifiche:

  1. Vai alla pagina Quote e Limiti di sistema:

    Vai a Quote e Limiti di sistema

  2. Fai clic su Filtra per eseguire una query sulla tua quota in base a una proprietà specifica.

Gestire la quota utilizzando la console

A seconda dell'utilizzo delle risorse, potresti voler aumentare o ridurre i valori di quota del progetto. Questa sezione descrive come modificare i valori di quota impostati. Per visualizzare i valori, fai clic su Tutte le quote nella colonna Dettagli.

Prima di iniziare

Prima di iniziare, assicurati di disporre delle autorizzazioni IAM (Identity and Access Management) necessarie per richiedere aggiustamenti per l'aumento della quota.

Per modificare la quota a livello di progetto, cartella o organizzazione, devi disporre della seguente autorizzazione IAM:

Questa autorizzazione è inclusa per impostazione predefinita per i seguenti ruoli: Proprietario, Editor, Amministratore quota e Amministratore utilizzo dei servizi.

Per ulteriori informazioni sulle autorizzazioni di Identity and Access Management (IAM) richieste, consulta Autorizzazioni per le quote.

Richiedere un valore di quota più elevato

Puoi richiedere un valore di quota più elevato utilizzando la console Google Cloud, l'API Cloud Quotas o Google Cloud CLI. Le istruzioni riportate di seguito mostrano come richiedere un nuovo valore di quota utilizzando la console Google Cloud o inviando una richiesta REST all'API Cloud Quotas.

console

Per richiedere un valore di quota più elevato dalla console Google Cloud, svolgi i seguenti passaggi:

  1. Vai alla pagina Quote e Limiti di sistema.

    Vai a Quote e Limiti di sistema

  2. Individua la quota che vuoi aumentare nella tabella Quote e Limiti di sistema. Puoi utilizzare la casella di ricerca Filtra per cercare la quota.

    Se stai cercando una quota regionale o zonale che non ha alcun utilizzo, utilizza la voce predefinita e seleziona la regione o la zona nel passaggio successivo. La voce predefinita è (default) alla fine del nome elencato nella colonna Nome.

  3. Nella riga della quota, fai clic su Altre azioni. Per richiedere un aggiustamento per tutte le regioni o zone, fai clic su Modifica quota. Per specificare regioni o zone per l'aggiustamento, segui i passaggi riportati di seguito prima di procedere se hai selezionato la voce predefinita per la quota.

    1. Fai clic su Seleziona le regioni/le zone da modificare.
    2. Seleziona le regioni o le zone e fai clic su OK.
    3. Fai clic su Modifica.

    Viene visualizzata la finestra di dialogo Modifiche alla quota.

  4. Se sopra il campo Nuovo valore è presente un link a Richiedi una quota più alta e vuoi aumentare il valore della quota oltre il numero indicato sullo schermo, segui il link. Compila il modulo, invialo e salta i passaggi rimanenti qui. In caso contrario, continua a seguire questa guida.

  5. Nel campo Nuovo valore, inserisci il valore della quota aumentata che vuoi. Se viene visualizzato un campo Descrizione della richiesta, inserisci una descrizione. Fai clic su Fine.

    Se vedi una casella di controllo con il testo "Sono consapevole che questa richiesta rimuoverà eventuali override", il valore della quota è impostato al di sotto del valore predefinito. Se il valore della quota viene impostato su un valore uguale o superiore a quello predefinito, l'override viene rimosso. Per continuare, seleziona la casella di controllo. Scopri di più sugli override della quota.

    Se viene visualizzato un pulsante Avanti, fai clic su Avanti e compila i dati di contatto nella schermata successiva.

  6. Fai clic su Invia richiesta.

Se non riesci a richiedere un adeguamento dalla console, richiedi l'aumento all'assistenza clienti Google Cloud.

Le richieste di adeguamento delle quote cloud sono soggette a revisione. Se la richiesta di adeguamento della quota richiede la revisione, riceverai un'email di conferma della ricezione della richiesta. Se hai bisogno di ulteriore assistenza, rispondi all'email. Dopo aver esaminato la richiesta, riceverai una notifica via email indicante se la richiesta è stata approvata.

Per scoprire di più su come funziona la procedura di aumento della quota, vedi Informazioni sulle richieste di aumento della quota.

Creazione di richieste batch per valori di quota più elevati

Puoi creare richieste batch per una quota più alta selezionando la casella di controllo accanto a ogni quota da includere. La creazione di richieste batch può aumentare il tempo necessario a Google Cloud per esaminare la tua richiesta. Per ridurre i tempi di revisione, raggruppa le richieste di adeguamento della quota per prodotto e area. Ad esempio, se vuoi richiedere adeguamenti alle quote di networking e di VM di Compute Engine, crea una richiesta per le quote di networking e un'altra per le quote di VM di Compute Engine.

REST

Per richiedere un valore di quota più elevato dall'API Cloud Quotas, utilizza il seguente esempio di codice. Compila i segnaposto modificabili con i tuoi valori. Per informazioni sui campi segnaposto, consulta le descrizioni che seguono il codice di esempio.

POST projects/PROJECT_NUMBER/locations/global/quotaPreferences?quotaPreferenceId=QUOTA_PREFERENCE_ID {
    "service": "SERVICE_ID",
    "quotaId": "QUOTA_ID",
    "quotaConfig": { "preferredValue": "NEW_QUOTA_VALUE" },
    "dimensions": { "DIMENSION_1": "VALUE_1", "DIMENSION_2": "VALUE_2" },
    "justification": "JUSTIFICATION",
    "contactEmail": "EMAIL"
}

Sostituisci quanto segue:

  • PROJECT_NUMBER: il numero del tuo progetto Google Cloud. Puoi trovare il numero del progetto nella pagina Welcome della console Google Cloud o eseguendo il seguente comando gcloud CLI:

    PROJECT=$(gcloud info --format='value(config.project)')
gcloud projects describe ${PROJECT} --format="value(projectNumber)"

  • QUOTA_PREFERENCE_ID: l'ID della preferenza di quota che stai aggiornando.

  • QUOTA_ID: l'ID della quota che stai aggiornando.

  • SERVICE_ID: l'ID della proprietà Google Cloud a cui appartiene la quota che stai modificando. Di solito ha il formato SERVICE_NAME.googleapis.com. Ad esempio, il nome del servizio Compute Engine è compute.googleapis.com.

  • DIMENSION_1: il tipo di dimensione da aggiustare, ad esempio region o zone. Puoi includere più dimensioni. Separa ogni dimensione dal relativo valore, ad esempio VALUE_1, con una virgola. Per modificare tutte le dimensioni della quota, ometti questa riga.

  • VALUE_1: il valore della dimensione precedente. Ad esempio, se la dimensione precedente è region, inserisci una regione come us-central1.

  • JUSTIFICATION: il motivo della richiesta.

  • EMAIL: un indirizzo email che può essere utilizzato come contatto, nel caso in cui Google Cloud abbia bisogno di ulteriori informazioni per prendere una decisione prima che possa essere concessa una quota aggiuntiva.

Richiesta di esempio

Di seguito è riportato un esempio di richiesta di aumento del valore della quota per la quota PUS-PER-GPU-FAMILY-per-project-region di Compute Engine. Richiede un valore di quota pari a 100 per le macchine della famiglia di GPU NVIDIA_H100 nella regione us-central1.

POST projects/123/locations/global/quotaPreferences?quotaPreferenceId=my_quota_preference_ID {
    "service": "compute.googleapis.com",
    "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region",
    "quotaConfig": { "preferredValue": 100 },
    "dimensions": { "region": "us-central1", "gpu_family": "NVIDIA_H100" },
    "justification": "My justification.",
    "contactEmail": "222larabrown@gmail.com"
}

Visualizzare le richieste di aumento della quota

Puoi visualizzare le richieste di aumento di quota in attesa e passate nella console Google Cloud.

Per visualizzare le richieste di aumento della quota in attesa:

  1. Assicurati di disporre dell'autorizzazione per visualizzare le richieste di aumento della quota.

  2. Vai alla pagina Quote e Limiti di sistema:

    Vai a Quote e Limiti di sistema

  3. Accanto ai valori delle quote in attesa di una decisione sulle richieste di aumento inviate in precedenza viene visualizzata l'icona In attesa. Fai clic su In attesa per visualizzare i dettagli delle richieste in attesa.

Le richieste in attesa vengono visualizzate anche nel modulo Modifiche alla quota quando sta per essere inviato un aggiustamento della quota.

Per visualizzare tutte le richieste di aumento della quota (attualmente in attesa e passate):

  1. Vai alla pagina Quote e Limiti di sistema:

    Vai a Quote e Limiti di sistema

  2. Fai clic sulla scheda Aumenta richieste.

  3. Fai clic su Filtra per eseguire una query sulle richieste di aumento della quota in base a una proprietà specifica.

Quando viene selezionata un'organizzazione o una cartella, la pagina mostra tutte le richieste di aumento della quota per tutti i progetti all'interno dell'organizzazione o della cartella.

Creare un override della quota

Potresti voler limitare l'utilizzo di una particolare risorsa impostando i tuoi valori di quota. Ad esempio, per evitare che ti venga fatturato l'utilizzo al di sopra dell'utilizzo gratuito di cortesia, puoi richiedere sostituzioni giornaliere. La creazione di un'override della quota è a volte indicata come limitazione dell'utilizzo.

Per eseguire l'override di una quota, segui gli stessi passaggi per la richiesta di una quota più alta.

L'override delle quote non si applica a tutti i servizi. Per ulteriori informazioni, consulta la pagina specifica della quota per il tuo servizio.

Reimpostare un valore di quota

Per reimpostare il valore della quota dopo l'applicazione di un'override:

  1. Vai alla pagina Quote e Limiti di sistema:

    Vai a Quote e Limiti di sistema

  2. Inserisci il testo nella casella di ricerca Filtra per cercare la quota. Imposta Has override: True per visualizzare solo le quote con una sostituzione.

  3. Nella pagina Quote, Sostituisci viene visualizzato accanto ai limiti di quota che hanno una sostituzione. Fai clic su Sostituisci per visualizzare i dettagli di questa quota e un'opzione per reimpostare il valore.

  4. Per confermare che un ripristino rimuove le sostituzioni, fai clic sulla casella di controllo precedente a Ripristina valore e poi su Ripristina valore per reimpostare la quota.

Per reimpostare una quota manualmente, segui la stessa procedura per richiedere un limite di quota più alto. Assicurati di impostare il Nuovo valore su un valore uguale al Valore predefinito visualizzato sotto il nome della quota nel modulo Modifiche alle quote.

Gestire la quota utilizzando l'API Cloud Quotas

Puoi utilizzare l'API Cloud Quotas per ottenere informazioni sulle quote attuali e impostare le preferenze relative alle quote per le API e i servizi Google Cloud. Per ulteriori informazioni, consulta quanto segue:

Gestire la quota utilizzando gcloud CLI

Per utilizzare gcloud CLI, assicurati di avere installato e inizializzato la versione più recente di gcloud CLI, incluso il componente comandi alpha. Se utilizzi Cloud Shell per interagire con Google Cloud, l'interfaccia alla gcloud CLI è già installata.

Per ulteriori informazioni, consulta le sezioni seguenti:

Passaggi successivi