L'API Cloud Quotas rappresenta le dimensioni come coppie chiave-valore. key
è
il nome della dimensione (ad esempio, region
). value
è il valore assegnato
alla dimensione (ad esempio, una regione come us-central1
).
Ad esempio, Compute Engine misura l'utilizzo delle VM utilizzando dimensioni diverse. La dimensione
region
misura il numero di VM che hai in una determinata regione.
Compute Engine dispone anche di una serie di dimensioni degli attributi di prodotto, tra cui
gpu_family
. La dimensione gpu_family
misura il numero di GPU di una
determinata famiglia nel tuo progetto Google Cloud .
Visualizza dimensioni
Puoi visualizzare le dimensioni per le quote e i limiti di sistema nella consoleGoogle Cloud , utilizzando Google Cloud CLI, eseguendo query sull'API REST o tramite le librerie client. Per visualizzare le dimensioni per le quali non hai specificato un valore, utilizza gcloud CLI. Utilizza anche gcloud CLI per visualizzare le dimensioni per le quote e i limiti di sistema che non hanno dimensioni regionali o di zona se il tuo progetto non utilizza già la risorsa associata. Questa sezione mostra come visualizzare le dimensioni utilizzando la console e gcloud CLI.
Console
Nella console Google Cloud , vai alla pagina IAM e amministrazione > Quote e limiti di sistema:
Vai a Quote e Limiti di sistema
La tabella in questa pagina mostra le dimensioni nella colonna Dimensioni.
Se non vedi la colonna Dimensioni, segui questi passaggi. In caso contrario, salta questo passaggio.
- Fai clic su Opzioni di visualizzazione delle colonne.
- Seleziona Dimensioni.
- Fai clic su OK. La colonna Dimensioni viene visualizzata nella tabella.
Per filtrare i risultati, inserisci il nome o il valore di una proprietà nel campo accanto a
Filtro.- Per filtrare per prodotto, inizia a inserire il nome del prodotto e selezionalo dall'elenco visualizzato.
- Per filtrare in base alla dimensione, inserisci la dimensione utilizzando il seguente formato:
dimension_name:dimension_value
. Ad esempio, per visualizzare le quote e i limiti di sistema definiti per la regione us-central1, inserisci:region:us-central
.
Informazioni sulle dimensioni vuote
A volte la colonna Dimensioni è vuota. Questa situazione può verificarsi per i seguenti motivi:
Il valore della quota o del limite di sistema è il valore predefinito e si applica a tutte le dimensioni. Per alcune quote e limiti di sistema, la console mostra una riga che elenca il valore predefinito della quota o del limite di sistema come riferimento. Poiché il valore predefinito si applica a tutti i valori delle dimensioni, la colonna Dimensioni è vuota. Per identificare queste voci, controlla la colonna Nome. La colonna Nome indica queste voci con la parola "predefinito" tra parentesi alla fine del nome della quota o del limite di sistema.
Ad esempio, la quota
SetIamPolicyRequestsPerMinutePerProject
è definita nella dimensioneregion
. La console mostra una voce di riferimento e una voce per ogni regione. Nella colonna Nome, la voce di riferimento è elencata come "Richieste SetIAMPolicy al minuto per regione (impostazione predefinita)". Per questa voce, la colonna Dimensioni è vuota.Non vengono applicate dimensioni. Ad esempio, la quota di Compute Engine
NETWORKS-per-project
non è associata a un attributo di regione, zona o prodotto, pertanto non ci sono dimensioni da visualizzare.
gcloud
Puoi utilizzare gcloud CLI per visualizzare le dimensioni per una singola quota o un singolo limite di sistema oppure per tutte le quote e tutti i limiti di sistema associati a un determinato prodotto. La visualizzazione delle dimensioni per una singola quota o un singolo limite di sistema è in genere più veloce rispetto alla visualizzazione delle dimensioni per tutte le quote e tutti i limiti di sistema associati a un prodotto. La risposta a una query per una singola quota è in genere di circa 200 righe. La risposta a una query per un prodotto può superare le 2000 righe.
Visualizza le dimensioni per una singola quota o un singolo limite di sistema con gcloud
Per visualizzare le dimensioni per una singola quota o un limite di sistema utilizzando gcloud CLI, esegui il seguente comando nel terminale:
gcloud beta quotas info describe QUOTA_ID --project=PROJECT_ID --service=SERVICE_ID
Sostituisci quanto segue:
QUOTA_ID
: l'ID della quota o del limite di sistema. Se non conosci il tuo ID quota, scegli una delle seguenti opzioni:- Per trovarlo, utilizza la console come descritto in Trovare l'ID quota.
- Visualizza tutte le dimensioni del prodotto associate alla quota o al limite di sistema che ti interessa. Questo comando non richiede l'ID quota. Consulta la sezione Visualizzare le dimensioni di un prodotto con gcloud CLI.
PROJECT_ID
: l'ID del tuo progetto Google Cloud. Per trovare l'ID progetto, scegli una delle seguenti opzioni:- Per trovare l'ID progetto utilizzando la console, consulta Identificazione dei progetti.
- Se hai impostato il progetto attuale come progetto predefinito nella configurazione di gcloud CLI, trova l'ID progetto eseguendo il seguente comando gcloud nel terminale:
gcloud config get-value project
SERVICE_ID
: l'ID servizio del prodotto associato alla quota o al limite di sistema. Ad esempio, se la quota è per le CPU A2 di Compute Engine, l'ID servizio ècompute.googleapis.com
.
Visualizzare le dimensioni di un prodotto con gcloud CLI
Per visualizzare le dimensioni per una singola quota o un limite di sistema utilizzando gcloud CLI, esegui il seguente comando nel terminale:
gcloud beta quotas info list --project=PROJECT_ID --service=SERVICE_ID
Sostituisci quanto segue:
PROJECT_ID
: l'ID del tuo progetto Google Cloud. Per trovare l'ID progetto, scegli una delle seguenti opzioni:- Per trovare l'ID progetto utilizzando la console, consulta Identificazione dei progetti.
- Se hai impostato il progetto attuale come progetto predefinito nella configurazione di gcloud CLI, trova l'ID progetto eseguendo il seguente comando gcloud nel terminale:
gcloud config get-value project
SERVICE_ID
: l'ID servizio del prodotto associato alla quota o al limite di sistema. Ad esempio, se la quota è per le CPU A2 di Compute Engine, l'ID servizio ècompute.googleapis.com
.
Precedenza delle dimensioni
Alcuni casi d'uso dell'API Cloud Quotas hanno configurazioni di dimensioni complesse.
Le quote possono essere configurate a un livello più granulare rispetto a regioni e zone.
Puoi ottenere questa granularità quando utilizzi dimensioni specifiche del servizio.
Ad esempio, gpu_family
e network_id
sono dimensioni specifiche del servizio
nel servizio Compute Engine. Le dimensioni sono definite da ogni singolo servizio e ogni servizio potrebbe avere un insieme diverso di dimensioni specifiche del servizio.
Quando lavori con le dimensioni della località o con quelle specifiche del servizio, viene applicata la seguente precedenza:
Una configurazione delle preferenze di quota con tutte le dimensioni specifiche del servizio e della località specificate ha la precedenza su qualsiasi altra configurazione.
Le configurazioni che specificano le dimensioni della località hanno la precedenza solo sulle configurazioni che contengono solo dimensioni specifiche del servizio.
Combinare le dimensioni
In una configurazione delle preferenze di quota, puoi combinare le dimensioni nei seguenti modi:
La configurazione può contenere sia dimensioni della località sia dimensioni specifiche del servizio. Questo è l'ordine più alto in termini di precedenza.
La configurazione può contenere solo dimensioni relative alla località. Questa configurazione si applica a tutte le dimensioni specifiche del servizio, ad eccezione di quelle configurate in modo esplicito con il metodo 1.
La configurazione può contenere solo dimensioni specifiche del servizio. Questa configurazione si applica a tutte le località, tranne quelle configurate esplicitamente con il metodo 1 o 2.
Se la configurazione contiene qualsiasi dimensione specifica del servizio, deve contenere tutte le dimensioni specifiche del servizio.
Puoi avere configurazioni senza dimensioni. Queste configurazioni si applicano a tutte le località e a tutte le dimensioni specifiche del servizio, ad eccezione di quelle configurate in modo esplicito.