Le seguenti sezioni contengono esempi gcloud alpha quotas info
e
Comandi gcloud alpha quotas preferences
. Questi comandi ti consentono di visualizzare
gestiscono le risorse QuotaInfo
e QuotaPreference
.
Puoi utilizzare Google Cloud CLI (gcloud CLI) per ottenere dati i valori delle quote e specificare le preferenze di quota per alcune API Google Cloud i servizi di machine learning.
Limitazioni
Cloud Quotas presenta le seguenti limitazioni:
Tutti gli aggiustamenti relativi all'aumento della quota sono soggetti all'approvazione di Google Cloud.
Puoi richiedere aggiustamenti di aumento e riduzione della quota per quote a livello di progetto.
Puoi richiedere aggiustamenti della riduzione della quota per project-, folder-, e a livello di organizzazione quote.
Prima di iniziare
Prima di iniziare, assicurati di installare e inizializzare gcloud CLI.
Potrebbe essere necessario anche il valore QUOTA_ID
. In questo caso, consulta le
istruzioni per trovare il tuo QUOTA_ID.
Installa e inizializza gcloud CLI
Per utilizzare gcloud CLI, assicurati di aver installato e inizializzato l'ultima versione gcloud CLI, inclusi i comandi alpha di strumento di authoring. Se utilizzi Cloud Shell per interagire con Google Cloud, gcloud CLI è installato automaticamente.
Trovare l'ID quota
Molti dei comandi gcloud CLI in questa pagina fanno riferimento al tuo ID quota valore.
Per trovare il valore dell'ID quota, utilizza il seguente comando gcloud CLI elenca le informazioni sulla quota per il servizio specificato:
Inserisci il seguente comando gcloud CLI in una finestra del terminale:
gcloud alpha quotas info list --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER
Sostituisci quanto segue:
SERVICE_NAME
: il nome del servizio con le quote che vuoi vedi, ad esempio, il nome del servizio per Cloud Logging èlogging.googleapis.com
PROJECT_ID_OR_NUMBER
: l'ID o il numero del progettoPer trovare l'ID progetto utilizzando la console Google Cloud, vai alla Pagina Resource Manager:
L'output del comando
gcloud alpha quotas info list
contiene testo simile al seguente esempio:... "quotaInfos": [ ... { "name": "projects/PROJECT_NUMBER/locations/global/services/compute.googleapis.com/quotaInfos/CPUS-per-project-region", "quotaId": "CPUS-per-project-region", "metric": "compute.googleapis.com/cpus", "containerType": "PROJECT", "dimensions": [ "region" ], "dimensionsInfo": [ { "details": { "value": 20 }, "applicableLocations": [ "us-central1", "us-central2", "us-west1", "us-east1" ] ... } ] }, ... ] ...
Cerca il valore che corrisponde a
quotaId
e utilizzalo quando specifichiQUOTA_ID
nelle sezioni seguenti.
Comandi di esempio per le informazioni sulla quota di gcloud
Questa sezione fornisce esempi che mostrano come utilizzare gcloud alpha quotas info
per visualizzare le informazioni sulla quota per un determinato servizio o per
dell'organizzazione.
QuotaInfo
è una risorsa di sola lettura che fornisce metadati e valore di quota
informazioni su una particolare quota
per un dato progetto, cartella
dell'organizzazione.
Visualizzare le informazioni sulla quota per un determinato servizio
Per visualizzare le informazioni sulla quota per un determinato servizio, esegui questo comando:
gcloud alpha quotas info describe QUOTA_ID --service=SERVICE_NAME \
--project=PROJECT_ID_OR_NUMBER
Sostituisci quanto segue:
QUOTA_ID
: l'ID della quotaSERVICE_NAME
: il nome del servizio con le quote che vuoi vedi, ad esempio, il nome del servizio per Cloud Logging èlogging.googleapis.com
PROJECT_ID_OR_NUMBER
: l'ID o il numero del progetto
Visualizzare le informazioni sulla quota per un'organizzazione
Per visualizzare i dettagli della quota dello stesso servizio per un'organizzazione, esegui il comando seguente:
gcloud alpha quotas info list --service=SERVICE_NAME --organization=ORGANIZATION_ID
Sostituisci quanto segue:
SERVICE_NAME
: il nome del servizio con le quote che vuoi vedi, ad esempio, il nome del servizio per Cloud Logging èlogging.googleapis.com
ORGANIZATION_ID
: l'ID della tua organizzazione
Comandi di esempio per le preferenze di quota di gcloud
Questa sezione fornisce esempi che mostrano come utilizzare gcloud alpha quotas preferences
per controllare le preferenze di quota esistenti e regolare il valore della quota.
La risorsa QuotaPreference
rappresenta la tua preferenza per un particolare
di dimensioni. Una dimensione è un attributo che rappresenta una regione
una zona o una dimensione specifica di un servizio, come gpu_family
o network_id
.
Controllare le preferenze esistenti
Per verificare le preferenze esistenti, esegui questo comando:
gcloud alpha quotas preferences list --project=PROJECT_ID_OR_NUMBER
Sostituisci PROJECT_ID_OR_NUMBER
con l'ID o il numero di progetto.
Controlla se ci sono preferenze esistenti con aggiustamenti della quota in attesa
Per verificare le preferenze esistenti con aggiustamenti della quota in attesa, aggiungi la
--reconciling-only=true
come mostrato nel seguente comando:
gcloud alpha quotas preferences list --project=PROJECT_ID_OR_NUMBER --reconciling-only=true
Sostituisci PROJECT_ID_OR_NUMBER
con l'ID o il numero di progetto.
Richiedere un aggiustamento dell'aumento della quota per una regione specifica se non è stata impostata una preferenza di quota
Per richiedere un aggiustamento dell'aumento della quota per una regione specifica quando una preferenza non è stato ancora impostato, esegui questo comando:
gcloud alpha quotas preferences create --preferred-value=PREFERRED_VALUE \
--quota-id=QUOTA_ID --service=SERVICE_NAME \
--project=PROJECT_ID_OR_NUMBER --preference-id=PREFERENCE_ID
Sostituisci quanto segue:
PREFERRED_VALUE
: il valore della quota preferitaQUOTA_ID
: l'ID della quotaSERVICE_NAME
: il nome del servizio con le quote che vuoi vedi, ad esempio, il nome del servizio per Cloud Logging èlogging.googleapis.com
PROJECT_ID_OR_NUMBER
: l'ID o il numero del progettoPREFERENCE_ID
: l'ID preferenza
Richiedi un aggiustamento dell'aumento della quota per una regione specifica quando è stata impostata una preferenza di quota
Per richiedere un aggiustamento dell'aumento della quota per una regione specifica ed è già presente un preferenza, esegui nuovamente questo comando:
gcloud alpha quotas preferences update PREFERENCE_ID --preferred-value=PREFERRED_VALUE \
--quota-id=QUOTA_ID --service=SERVICE_NAME--project=PROJECT_ID_OR_NUMBER
Sostituisci quanto segue:
PREFERENCE_ID
: l'ID preferenzaPREFERRED_VALUE</var>"}}
: il valore della quota preferitaQUOTA_ID
: l'ID della quotaSERVICE_NAME
: il nome del servizio con le quote che vuoi vedi, ad esempio, il nome del servizio per Cloud Logging èlogging.googleapis.com
PROJECT_ID_OR_NUMBER
: l'ID o il numero del progetto
Recupera una preferenza di quota esistente
Per recuperare una preferenza di quota esistente, esegui il comando seguente:
gcloud alpha quotas preferences describe PREFERENCE_ID project=PROJECT_ID_OR_NUMBER
Sostituisci quanto segue:
PREFERENCE_ID
: l'ID preferenzaPROJECT_ID_OR_NUMBER
: l'ID o il numero del progetto
Altri servizi con comandi gcloud CLI relativi alle quote
Oltre a gcloud alpha quotas
, alcuni servizi hanno il proprio accesso da riga di comando
alle informazioni sulla quota e sull'utilizzo delle risorse.
Ad esempio, Compute Engine consente di accedere alle informazioni sulla quota. Per maggiori dettagli, consulta le seguenti sezioni di Compute Engine:
- Quote di allocazione
- Panoramica di gcloud CLI compute
- gcloud CLI compute del riferimento per Google Cloud SDK.
Passaggi successivi
Per un elenco completo dei comandi e dei flag gcloud alpha quotas
, consulta le
quote gcloud alpha
del riferimento per Google Cloud CLI.
Per ulteriori informazioni sulla terminologia relativa alle quote, consulta Informazioni sui valori di quota e i limiti di sistema.