Visualizzare e gestire le quote

Questo documento descrive come visualizzare i valori di quota nella consoleGoogle Cloud . Puoi anche gestire le quote dalla consoleGoogle Cloud , dall'API Cloud Quotas e da Google Cloud CLI (gcloud CLI).

Limitazioni

Cloud Quotas presenta le seguenti limitazioni:

  • Nella maggior parte dei casi, gli aggiustamenti dell'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 verificare se un Google Cloud prodotto supporta gli aggiustamenti dell'aumento della quota a livello di organizzazione, consulta la documentazione relativa al prodotto.

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

Prima di iniziare

Le attività descritte in questo documento richiedono ruoli Identity and Access Management (IAM).

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per richiedere aggiustamenti della quota, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto, nella cartella o nell'organizzazione:

  • Per visualizzare le quote: Quota Viewer (roles/servicemanagement.quotaViewer)
  • Per richiedere aggiustamenti delle quote: Quota Administrator (roles/servicemanagement.quotaAdmin)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per richiedere aggiustamenti della quota. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per richiedere aggiustamenti delle quote sono necessarie le seguenti autorizzazioni:

  • Per richiedere aggiustamenti delle quote: serviceusage.quotas.update

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Visualizza le quote nella console Google Cloud

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

Visualizza le quote per il tuo progetto

La pagina IAM e amministrazione > Quote e limiti di sistema mostra una tabella con colonne configurabili. Le colonne Servizio e Quota forniscono informazioni generali sulla quota descritta. Ad esempio, il Servizio potrebbe essere l'API Cloud Logging e la 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, ogni 100 secondi o al 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 nel tuo progetto, segui questi passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina IAM e amministrazione > 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. 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 di organizzazione, seleziona l'organizzazione o la cartella dal selettore delle risorse.

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

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

  • Per le quote di velocità al minuto:

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

  • Per le quote di frequenza giornaliera:

    • L'utilizzo totale accumulato nella giornata corrente, in base al fuso orario standard del Pacifico.

  • Per le quote di allocazione:

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

  • Per le quote simultanee:

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

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

Visualizzare ed esportare l'utilizzo della quota nel tempo

Puoi visualizzare l'utilizzo delle quote nel tempo con i grafici. La pagina Quote e limiti di sistema della console fornisce grafici per ogni singola quota o limite di sistema presente nella tabella Quote e limiti di sistema. Dopo aver visualizzato un grafico, puoi esportarlo. Per visualizzare ed esportare un grafico:

Console

  1. Nella console Google Cloud , vai alla pagina IAM e amministrazione > Quote e limiti di sistema:

    Vai a Quote e Limiti di sistema

  2. Trova la quota o il limite di sistema che ti interessa. Nella voce per questa quota o limite di sistema, fai clic su Mostra grafico di utilizzo. Si apre la visualizzazione del grafico.

  3. Nella visualizzazione del grafico, imposta il periodo di tempo. Il valore predefinito è 7 giorni. Per modificare questo valore, fai clic sul menu del periodo di tempo e seleziona il periodo di tempo che preferisci.

  4. Per esportare il grafico, fai clic su Altre opzioni del grafico e poi seleziona Scarica > Scarica PNG. Il grafico viene scaricato come file PNG.

Per scoprire di più sui grafici, vedi Configura il monitoraggio e gli avvisi relativi alla quota.

Visualizzare le quote specifiche 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.

Se non è presente un valore per una determinata quota, il valore viene visualizzato come Unlimited.

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 o nella pagina API e servizi. Utilizza la visualizzazione della console che preferisci:

Console

  • Per visualizzare le quote specifiche dell'API dalla pagina Quote e limiti di sistema utilizzando un filtro:

    1. Nella console Google Cloud , vai alla pagina IAM e amministrazione > Quote e limiti di sistema:

      Vai a Quote e Limiti di sistema

    2. Fai clic su Filtro e seleziona Servizio dal menu visualizzato.

    3. Seleziona o inserisci il nome del servizio che vuoi visualizzare.

      La pagina mostra le informazioni sulle quote e sui limiti di sistema per l'API specificata. I numeri visualizzati nella colonna Value sono i valori di quota predefiniti, a meno che tu non abbia apportato un aggiustamento della quota.

  • Per visualizzare le quote specifiche per le API dalla pagina API e servizi:

    1. Vai alla pagina API e servizi:

      Vai su API e servizi

    2. Seleziona il progetto.

    3. Fai clic sul nome dell'API per il servizio che vuoi visualizzare.

    4. Fai clic sulla scheda Quote e limiti di sistema.

      La pagina mostra le informazioni sulle quote e sui limiti di sistema per l'API specificata. I numeri visualizzati nella colonna Value sono i valori di quota predefiniti, a meno che tu non abbia apportato un aggiustamento della quota.

Per visualizzare l'utilizzo nel tempo, fai clic su Mostra grafico di utilizzo.

Filtra quote

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

Console

  1. Nella console Google Cloud , vai alla pagina IAM e amministrazione > Quote e limiti di sistema:

    Vai a Quote e Limiti di sistema

  2. Fai clic su Filtro per eseguire una query sulle tue quote in base a un nome o un valore di proprietà specifico.

Gestire le quote 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 forniti. Per visualizzare i valori, fai clic su Tutte le quote nella colonna Dettagli.

Richiedi un aggiustamento delle quote

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. Puoi richiedere un aggiustamento della quota utilizzando la console Google Cloud , l'API Cloud Quotas o Google Cloud CLI. Le seguenti istruzioni mostrano come richiedere un nuovo valore di quota utilizzando la console Google Cloud o effettuando una richiesta REST all'API Cloud Quotas.

Console

Per richiedere una modifica della quota:

  1. Nella console Google Cloud , vai alla pagina IAM e amministrazione > Quote e limiti di sistema:

    Vai a Quote e Limiti di sistema

    Se ti viene chiesto di selezionare un progetto, seleziona quello che vuoi modificare.

  2. Trova la quota che vuoi modificare e apri la finestra di dialogo Modifiche alla quota:

    • Quote non presenti nella tabella:

      • Cerca la quota nella casella di ricerca Filtra. Non specificare la regione o la zona (se applicabile) perché le quote che non hanno valori di utilizzo o aggiustati non vengono visualizzate nella tabella.
      • Individua eventuali voci relative alla tua quota nella tabella. Può essere la voce predefinita o qualsiasi voce con cronologia, indipendentemente dalla regione o dalla zona.
      • Nella riga della voce, fai clic su Altre azioni > Configura regioni/zone aggiuntive.
      • Seleziona la regione o la zona che vuoi regolare. Fai clic su Modifica.

    • Tutte le altre quote:

      • Cerca la quota nella casella di ricerca Filtra.
      • Nella riga relativa alla voce, seleziona la casella di controllo per la quota.
      • Fai clic su Modifica.

    Viene visualizzata la finestra di dialogo Modifiche alla quota.

  3. Se sopra il campo Nuovo valore vedi 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. In caso contrario, continua a seguire questa guida.

  4. 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.

  5. Fai clic su Invia richiesta.

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

Per scoprire di più su come funziona la procedura di aumento della quota, vedi Informazioni sugli aggiustamenti delle quote.

Creazione di batch di richieste per gli aggiustamenti delle quote

Puoi creare richieste batch per gli aggiustamenti delle quote selezionando la casella di controllo per ogni quota da includere. Tuttavia, 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 aggiustamento della quota 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 l'esempio di codice.

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 tuo numero di progetto Google Cloud . Puoi trovare il numero di progetto nella pagina Benvenuto 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 di 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 che vuoi modificare, ad esempio region o zone. Puoi includere più dimensioni. Separa ogni dimensione seguendo il suo 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 di questa 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 di poter concedere una quota aggiuntiva.

Esempio di richiesta

Di seguito è riportato un esempio di richiesta di aumento del valore della quota per la quota di Compute Engine PUS-PER-GPU-FAMILY-per-project-region. Richiede un valore di quota di 100 per le macchine della famiglia di GPU NVIDIA_H100 che si trovano 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 della quota in attesa e passate nella consoleGoogle Cloud .

Per visualizzare le richieste di aumento delle quote in attesa:

Console

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

  2. Nella console Google Cloud , vai alla pagina IAM e amministrazione > 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 un'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 un aggiustamento della quota sta per essere inviato.

Per visualizzare tutte le richieste di aumento della quota, incluse quelle in attesa e quelle passate:

Console

  1. Nella console Google Cloud , vai alla pagina IAM e amministrazione > Quote e limiti di sistema:

    Vai a Quote e Limiti di sistema

  2. Fai clic sulla scheda Richieste di aumento.

  3. Fai clic su Filtra per eseguire una query sulle tue 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.

Crea un override della quota

Per limitare l'utilizzo di una particolare risorsa, crea un override della quota modificando il valore della quota in un valore inferiore a quello predefinito. La creazione di una sostituzione della quota viene a volte definita utilizzo del limite.

Per creare un override della quota, segui i passaggi per aggiornare un valore di quota.

Le sostituzioni delle quote non sono disponibili per tutti i servizi. Per informazioni specifiche del servizio, consulta la documentazione relativa alle quote e ai limiti di sistema per il tuo servizio.

Reimpostare un valore di quota

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

Console

  1. Nella console Google Cloud , vai alla pagina IAM e amministrazione > Quote e limiti di sistema:

    Vai a Quote e Limiti di sistema

  2. Inserisci il testo nella casella di ricerca Filtra per cercare la tua quota. Imposta Has override: True per mostrare solo le quote che hanno un override.

  3. Nella pagina Quote, Override viene visualizzato accanto ai limiti di quota che hanno un override. 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 che precede Reimposta valore e poi fai clic su Reimposta valore per reimpostare la quota.

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

Gestire le quote utilizzando l'API Cloud Quotas

Puoi utilizzare l'API Cloud Quotas per ottenere informazioni sulle quote attuali e impostare le preferenze di quota per Google Cloud API e servizi. Per maggiori informazioni, consulta le seguenti risorse:

Gestisci le quote utilizzando gcloud CLI

Per utilizzare gcloud CLI, assicurati di aver installato e inizializzato l'ultima versione di gcloud CLI, incluso il componente comandi beta. Se utilizzi Cloud Shell per interagire con Google Cloud, gcloud CLI è già installato.

Per ulteriori informazioni, consulta le sezioni seguenti:

Richiedere la quota del progetto

Per ulteriori informazioni sulla richiesta di quote di progetto aggiuntive, consulta l'articolo di assistenza Richieste di quote di progetto.

Passaggi successivi