L'API Cloud Quotas rappresenta le dimensioni come coppie chiave-valore. key
è il nome della dimensione (ad es. region
). value
è il valore assegnato per la dimensione (ad es. 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 in una determinata regione.
Compute Engine ha anche una serie di dimensioni degli attributi dei prodotti, tra cuigpu_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 console Google 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 l'interfaccia alla gcloud CLI. Utilizza anche la gcloud CLI per visualizzare le dimensioni per le quote e i limiti di sistema che non hanno dimensioni regionali o zonali se il tuo progetto non utilizza già la risorsa associata. Questa sezione mostra come visualizzare le dimensioni utilizzando la console e l'interfaccia alla gcloud CLI.
console
Vai alla pagina 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, svolgi i seguenti passaggi. In caso contrario, salta questo passaggio.
- Fai clic su Opzioni di visualizzazione delle colonne.
- Seleziona Dimensioni.
- Fai clic su OK. Nella tabella viene visualizzata la colonna Dimensioni.
Per filtrare i risultati, inserisci il nome o il valore di una proprietà nel campo accanto a
Filtro.- Per filtrare per prodotto, inizia a digitare il nome del prodotto e selezionalo dall'elenco visualizzato.
- Per filtrare in base a una dimensione, inseriscila 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. Questo può accadere 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. Controlla la colonna Nome per identificare queste voci. 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 sulla 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 (valore predefinito)". 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 regione, zona o prodotto, pertanto non sono presenti dimensioni da visualizzare.
gcloud
Puoi utilizzare l'gcloud CLI per visualizzare le dimensioni di una singola quota o di un limite di sistema oppure di tutte le quote e i limiti di sistema associati a un determinato prodotto. La visualizzazione delle dimensioni per una singola quota o un limite di sistema è in genere più rapida rispetto alla visualizzazione delle dimensioni per tutte le quote e 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 su un prodotto può superare le 2000 righe.
Visualizzare le dimensioni di una singola quota o di un limite di sistema con gcloud
Per visualizzare le dimensioni di una singola quota o di un limite di sistema utilizzando gcloud CLI, esegui il seguente comando nel terminale:
gcloud alpha 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 l'ID quota, scegli una delle seguenti opzioni:- Puoi trovarlo utilizzando 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 l'interfaccia a riga di comando gcloud.
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 corrente come progetto predefinito nella configurazione 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 riguarda 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 di una singola quota o di un limite di sistema utilizzando gcloud CLI, esegui il seguente comando nel terminale:
gcloud alpha 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 corrente come progetto predefinito nella configurazione 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 riguarda 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 complesse delle dimensioni.
Le quote possono essere configurate a un livello più granulare rispetto a regioni e zone.
Puoi ottenere questa granularità quando utilizzi dimensioni specifiche per 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.
Quando utilizzi le dimensioni relative alla località o quelle specifiche per i servizi, viene applicata la seguente precedenza:
Una configurazione delle preferenze di quota con tutte le dimensioni specifiche per località e servizio specificate ha la precedenza su qualsiasi altra configurazione.
Le configurazioni che specificano le dimensioni di località hanno la precedenza solo sulle configurazioni contenenti solo dimensioni specifiche del servizio.
Combinazione di dimensioni
In una configurazione delle preferenze relative alle quote, puoi combinare le dimensioni nei seguenti modi:
La configurazione può contenere sia le dimensioni relative alla località sia quelle specifiche del servizio. Questo è l'ordine di precedenza più alto.
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 esplicitamente con il metodo 1.
La configurazione può contenere solo dimensioni specifiche del servizio. Questa configurazione si applica a tutte le località, ad eccezione di 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 esplicitamente.