Gestire le quote utilizzando l'interfaccia a riga di comando gcloud beta

Le seguenti sezioni contengono esempi di comandi gcloud beta quotas info e gcloud beta quotas preferences. Questi comandi ti consentono di visualizzare e gestire le risorse QuotaInfo e QuotaPreference.

Puoi utilizzare Google Cloud CLI (gcloud CLI) per ottenere i valori delle quote attuali e specificare le preferenze di quota per alcuni servizi e alcune API Google Cloud .

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 prodotto Google Cloud supporta gli aggiustamenti dell'aumento della quota a livello di organizzazione, consulta la documentazione di quel prodotto.

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

Prima di iniziare

Prima di utilizzare gcloud CLI, assicurati di installarla e inizializzarla.

Potrebbe servirti anche il valore QUOTA_ID. In questo caso, consulta le istruzioni per trovare l'ID quota.

Installa e inizializza gcloud CLI

Per utilizzare gcloud CLI per Cloud Quotas, assicurati di installare e inizializzare i componenti:

1. Installa gcloud CLI.

   Se utilizzi Cloud Shell, puoi saltare questo passaggio perché gcloud CLI è preinstallato.

2. Inizializza gcloud CLI.

3. Installa il componente beta eseguendo questo comando:

   gcloud components install beta
   

Trovare l'ID quota

Diversi comandi dell'interfaccia a riga della gcloud CLI in questa pagina fanno riferimento al valore dell'ID quota. Puoi trovare l'ID quota utilizzando la console Google Cloud , gcloud CLI, le librerie client o l'API REST. Questa sezione mostra come trovare l'ID quota utilizzando la console Google Cloud o gcloud CLI.

Comandi gcloud di esempio per le informazioni sulle quote

Questa sezione fornisce esempi che mostrano come utilizzare i comandi gcloud beta quotas info per visualizzare le informazioni sulla quota per un servizio specifico o per un'organizzazione.

QuotaInfo è una risorsa di sola lettura che fornisce metadati e informazioni sul valore della quota per una determinata quota per un determinato progetto, cartella o organizzazione.

Visualizzare le informazioni sulla quota per un servizio specifico

Per visualizzare le informazioni sulla quota per un determinato servizio, esegui il seguente comando:

gcloud beta quotas info describe QUOTA_ID --service=SERVICE_NAME \
    --project=PROJECT_ID_OR_NUMBER --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Sostituisci quanto segue:

• QUOTA_ID: il valore dell'ID quota. Per trovare questo valore, vedi Trovare l'ID quota.
• SERVICE_NAME: il nome del servizio con le quote che vuoi visualizzare. Ad esempio, il nome del servizio per Compute Engine è compute.googleapis.com.
• PROJECT_ID_OR_NUMBER: l'ID progetto o il numero di progetto

• BILLING_PROJECT_ID_OR_NUMBER: l'ID progetto o il numero di progetto per l'utilizzo di quota e fatturazione. L'esecuzione di un comando gcloud influisce sulla quota come se avessi effettuato la richiesta equivalente direttamente tramite un'API REST o RPC.

  Specifica il progetto di cui vuoi utilizzare la quota. Può essere diverso dal progetto contenente il servizio per cui stai visualizzando le informazioni sulla quota.

  Se hai già impostato il progetto di fatturazione durante la configurazione di gcloud CLI, questo flag è facoltativo. In caso contrario, la sua omissione potrebbe causare un errore di autorizzazione negata. Per ulteriori informazioni, consulta Impostare il progetto di quota.

Visualizzare le informazioni sulla quota per un'organizzazione

Per visualizzare i dettagli della quota dello stesso servizio per un'organizzazione, esegui questo comando:

gcloud beta quotas info list --service=SERVICE_NAME --organization=ORGANIZATION_ID \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Sostituisci quanto segue:

• SERVICE_NAME: il nome del servizio con le quote che vuoi visualizzare. Ad esempio, il nome del servizio per Compute Engine è compute.googleapis.com.
• ORGANIZATION_ID: l'ID della tua organizzazione

• BILLING_PROJECT_ID_OR_NUMBER: l'ID progetto o il numero di progetto per l'utilizzo di quota e fatturazione. L'esecuzione di un comando gcloud influisce sulla quota come se avessi effettuato la richiesta equivalente direttamente tramite un'API REST o RPC.

  Specifica il progetto di cui vuoi utilizzare la quota. Può essere diverso dal progetto contenente il servizio per cui stai visualizzando le informazioni sulla quota.

  Se hai già impostato il progetto di fatturazione durante la configurazione di gcloud CLI, questo flag è facoltativo. In caso contrario, la sua omissione potrebbe causare un errore di autorizzazione negata. Per ulteriori informazioni, consulta Impostare il progetto di quota.

Esempi di comandi gcloud per le preferenze di quota

Questa sezione fornisce esempi che mostrano come utilizzare i comandi gcloud beta quotas preferences per controllare le preferenze di quota esistenti e modificare il valore della quota.

La risorsa QuotaPreference rappresenta la tua preferenza per una particolare combinazione di dimensioni. Una dimensione è un attributo che rappresenta una regione o una zona oppure una dimensione specifica del servizio, ad esempio gpu_family o network_id.

Controllare le preferenze esistenti

Per verificare le preferenze esistenti, esegui questo comando:

gcloud beta quotas preferences list --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Sostituisci quanto segue:

• PROJECT_ID_OR_NUMBER : l'ID progetto o il numero di progetto

• BILLING_PROJECT_ID_OR_NUMBER: l'ID progetto o il numero di progetto per l'utilizzo di quota e fatturazione. L'esecuzione di un comando gcloud influisce sulla quota come se avessi effettuato la richiesta equivalente direttamente tramite un'API REST o RPC.

  Specifica il progetto di cui vuoi utilizzare la quota. Può essere diverso dal progetto per cui stai controllando le preferenze di quota.

  Se hai già impostato il progetto di fatturazione durante la configurazione di gcloud CLI, questo flag è facoltativo. In caso contrario, la sua omissione potrebbe causare un errore di autorizzazione negata. Per ulteriori informazioni, consulta Impostare il progetto di quota.

Controllare le preferenze esistenti con aggiustamenti della quota in attesa

Per verificare la presenza di preferenze esistenti con aggiustamenti della quota in attesa, aggiungi il flag --reconciling-only=true come mostrato nel seguente comando:

gcloud beta quotas preferences list --project=PROJECT_ID_OR_NUMBER --reconciling-only=true \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Sostituisci quanto segue:

• PROJECT_ID_OR_NUMBER : l'ID progetto o il numero di progetto

• BILLING_PROJECT_ID_OR_NUMBER: l'ID progetto o il numero di progetto per l'utilizzo di quota e fatturazione. L'esecuzione di un comando gcloud influisce sulla quota come se avessi effettuato la richiesta equivalente direttamente tramite un'API REST o RPC.

  Specifica il progetto di cui vuoi utilizzare la quota. Può essere diverso dal progetto per cui stai controllando le preferenze di quota.

  Se hai già impostato il progetto di fatturazione durante la configurazione di gcloud CLI, questo flag è facoltativo. In caso contrario, la sua omissione potrebbe causare un errore di autorizzazione negata. Per ulteriori informazioni, consulta Impostare il progetto di quota.

Richiedere un aggiustamento dell'aumento della quota quando non è ancora stata impostata una preferenza di quota

Per richiedere un aggiustamento dell'aumento della quota per una regione specifica quando una preferenza non è ancora stata impostata, esegui questo comando:

gcloud beta quotas preferences create --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME  --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER --email=EMAIL \
    --justification=JUSTIFICATION --preference-id=PREFERENCE_ID

Sostituisci quanto segue:

• PREFERRED_VALUE: il valore della quota preferita
• QUOTA_ID: il valore dell'ID quota. Per trovare questo valore, vedi Trovare l'ID quota.
• SERVICE_NAME: il nome del servizio con le quote che vuoi visualizzare. Ad esempio, il nome del servizio per Compute Engine è compute.googleapis.com.
• PROJECT_ID_OR_NUMBER: l'ID progetto o il numero di progetto

• BILLING_PROJECT_ID_OR_NUMBER: l'ID progetto o il numero di progetto per l'utilizzo di quota e fatturazione. L'esecuzione di un comando gcloud influisce sulla quota come se avessi effettuato la richiesta equivalente direttamente tramite un'API REST o RPC.

  Specifica il progetto di cui vuoi utilizzare la quota. Può essere diverso dal progetto per cui stai richiedendo una modifica della quota.

  Se hai già impostato il progetto di fatturazione durante la configurazione di gcloud CLI, questo flag è facoltativo. In caso contrario, la sua omissione potrebbe causare un errore di autorizzazione negata. Per ulteriori informazioni, consulta Impostare il progetto di quota.

• EMAIL: un indirizzo email che può essere utilizzato come contatto, nel caso in cui Google Cloud abbia bisogno di ulteriori informazioni prima di poter concedere una quota aggiuntiva

• JUSTIFICATION: una stringa facoltativa che spiega la tua richiesta

• PREFERENCE_ID: un ID preferenza facoltativo; se non specifichi un ID preferenza, l'API genera un identificatore univoco universale (UUID) per te

Richiedere un aggiustamento dell'aumento della quota quando è stata impostata una preferenza di quota

Per richiedere un aggiustamento dell'aumento della quota per una regione specifica e se esiste già una preferenza, esegui questo comando:

gcloud beta quotas preferences update PREFERENCE_ID --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER --email=EMAIL  \
    --justification=JUSTIFICATION

Sostituisci quanto segue:

• PREFERENCE_ID: l'ID preferenza, obbligatorio come primo argomento quando si utilizza il comando gcloud beta quotas preferences update
• PREFERRED_VALUE: il valore della quota preferita
• QUOTA_ID: il valore dell'ID quota. Per trovare questo valore, vedi Trovare l'ID quota.
• SERVICE_NAME: il nome del servizio con le quote che vuoi visualizzare. Ad esempio, il nome del servizio per Compute Engine è compute.googleapis.com.
• PROJECT_ID_OR_NUMBER: l'ID progetto o il numero di progetto

• BILLING_PROJECT_ID_OR_NUMBER: l'ID progetto o il numero di progetto per l'utilizzo di quota e fatturazione. L'esecuzione di un comando gcloud influisce sulla quota come se avessi effettuato la richiesta equivalente direttamente tramite un'API REST o RPC.

  Specifica il progetto di cui vuoi utilizzare la quota. Può essere diverso dal progetto per cui stai richiedendo una modifica della quota.

  Se hai già impostato il progetto di fatturazione durante la configurazione di gcloud CLI, questo flag è facoltativo. In caso contrario, la sua omissione potrebbe causare un errore di autorizzazione negata. Per ulteriori informazioni, consulta Impostare il progetto di quota.

• EMAIL: un indirizzo email che può essere utilizzato come contatto, nel caso in cui Google Cloud abbia bisogno di ulteriori informazioni prima di poter concedere una quota aggiuntiva

• JUSTIFICATION: una stringa facoltativa che spiega la tua richiesta

Richiedere un aggiustamento dell'aumento della quota utilizzando una dimensione

Per richiedere una modifica dell'aumento della quota utilizzando una dimensione, esegui questo comando:

gcloud beta quotas preferences create --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
    --dimensions=KEY1=VALUE1,KEY2=VALUE2,... --billing-project=BILLING_PROJECT_ID_OR_NUMBER \
    --email=EMAIL --justification=JUSTIFICATION --preference-id=PREFERENCE_ID

Sostituisci quanto segue:

• PREFERRED_VALUE: il valore della quota preferita
• QUOTA_ID: il valore dell'ID quota. Per trovare questo valore, vedi Trovare l'ID quota.
• SERVICE_NAME: il nome del servizio con le quote che vuoi visualizzare. Ad esempio, il nome del servizio per Compute Engine è compute.googleapis.com.
• PROJECT_ID_OR_NUMBER: l'ID progetto o il numero di progetto
• KEY1=VALUE1,KEY2=VALUE2,...: un elenco facoltativo che specifica la dimensione come elenco separato da virgole di coppie chiave-valore. Ad esempio, la dimensione potrebbe specificare i seguenti valori di Compute Engine:
  • KEY1=VALUE1: region=us-east4
  • KEY2=VALUE2: gpu_family=NVIDIA_H100

• BILLING_PROJECT_ID_OR_NUMBER: l'ID progetto o il numero di progetto per l'utilizzo di quota e fatturazione. L'esecuzione di un comando gcloud influisce sulla quota come se avessi effettuato la richiesta equivalente direttamente tramite un'API REST o RPC.

  Specifica il progetto di cui vuoi utilizzare la quota. Può essere diverso dal progetto per cui stai richiedendo una modifica della quota.

  Se hai già impostato il progetto di fatturazione durante la configurazione di gcloud CLI, questo flag è facoltativo. In caso contrario, la sua omissione potrebbe causare un errore di autorizzazione negata. Per ulteriori informazioni, consulta Impostare il progetto di quota.

• EMAIL: un indirizzo email che può essere utilizzato come contatto, nel caso in cui Google Cloud abbia bisogno di ulteriori informazioni prima di poter concedere una quota aggiuntiva

• JUSTIFICATION: una stringa facoltativa che spiega la tua richiesta

• PREFERENCE_ID: un ID preferenza facoltativo; se non specifichi un ID preferenza, l'API genera un identificatore univoco universale (UUID) per te

L'output conterrà dati specifici per la tua configurazione e sarà simile al seguente esempio:

{
    "createTime":"CREATE_TIME",
    "dimensions":{
        "gpu_family":"NVIDIA_H100",
        "region":"us-east4"
    },
    "etag":"ETAG_VALUE",
    "name":"projects/12345/locations/global/quotaPreferences/PREFERENCE_ID",
    "quotaConfig":{
        "grantedValue":"0",
        "preferredValue":"128",
        "traceId":"TRACE_ID"
    },
    "quotaId":"GPUS-PER-GPU-FAMILY-per-project-region",
    "reconciling":true,
    "service":"compute.googleapis.com",
    "updateTime":"UPDATE_TIME",
}

Visualizzare una preferenza di quota esistente

Per visualizzare i dettagli della preferenza di quota appena creata, esegui questo comando:

gcloud beta quotas preferences describe PREFERENCE_ID \
    --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Sostituisci quanto segue:

• PREFERENCE_ID: l'ID preferenza, obbligatorio come primo argomento quando si utilizza il comando gcloud beta quotas preferences describe
• PROJECT_ID_OR_NUMBER: l'ID progetto o il numero di progetto

• BILLING_PROJECT_ID_OR_NUMBER: l'ID progetto o il numero di progetto per l'utilizzo di quota e fatturazione. L'esecuzione di un comando gcloud influisce sulla quota come se avessi effettuato la richiesta equivalente direttamente tramite un'API REST o RPC.

  Specifica il progetto di cui vuoi utilizzare la quota. Può essere diverso dal progetto per cui stai visualizzando la preferenza di quota.

  Se hai già impostato il progetto di fatturazione durante la configurazione di gcloud CLI, questo flag è facoltativo. In caso contrario, la sua omissione potrebbe causare un errore di autorizzazione negata. Per ulteriori informazioni, consulta Impostare il progetto di quota.

L'output conterrà dati specifici per la tua configurazione e sarà simile al seguente esempio:

createTime: 'CREATE_TIME'
dimensions:
  gpu_family: NVIDIA_H100
  region: us-east4
etag: ETAG_VALUE
name: projects/12345/locations/global/quotaPreferences/PREFERENCE_ID
quotaConfig:
  grantedValue: '0'
  preferredValue: '128'
  traceId: TRACE_ID
quotaId: GPUS-PER-GPU-FAMILY-per-project-region
reconciling: true
service: compute.googleapis.com
updateTime: 'UPDATE_TIME'

Abilitare l'aggiustamento delle quote tramite un progetto client

Un progetto client si riferisce al progetto utilizzato da un'applicazione o da un utente per accedere e interagire con le risorse di Google Cloud , mentre un progetto di risorse è il progetto sottostante in cui vengono archiviate e gestite queste risorse.

Per attivare lo strumento di aggiustamento delle quote tramite un progetto client utilizzando gcloud CLI, segui questi passaggi:

1. Creare un progetto cliente:

   gcloud projects create CLIENT_PROJECT_ID
   gcloud config set project CLIENT_PROJECT_ID
   

   Sostituisci CLIENT_PROJECT_ID con l'ID del progetto che vuoi creare. Gli ID progetto sono immutabili e possono essere impostati solo durante la creazione del progetto. Devono iniziare con una lettera minuscola e possono contenere lettere ASCII minuscole, cifre o trattini. Gli ID progetto devono essere compresi tra 6 e 30 caratteri.

2. Abilita l'API Cloud Quotas nel progetto client:

   gcloud services enable cloudquotas.googleapis.com
   

3. Crea un service account nel progetto client:

   gcloud iam service-accounts create SA_NAME \
     --display-name SA_DISPLAY_NAME \
     --project=CLIENT_PROJECT_ID
   

   Sostituisci quanto segue:

   • SA_NAME: il nome interno del nuovo account di servizio. Utilizzato per generare un IAM_ACCOUNT (un indirizzo email interno IAM utilizzato come identificatore delaccount di serviziot), che deve essere passato ai comandi successivi.
   • SA_DISPLAY_NAME: il nome visualizzato del account di servizio.
   • CLIENT_PROJECT_ID: l'ID del progetto cliente.

4. Crea una chiave dell'account di servizio:

   gcloud iam service-accounts keys create KEY_FILE \
     --iam-account=SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com
   

   Sostituisci quanto segue:

   • KEY_FILE: il percorso del file JSON della chiave dell'account di servizio.
   • SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com: l'indirizzo email del account di servizio.

5. Concedi le autorizzazioni IAM al account di servizio:

   gcloud projects add-iam-policy-binding CLIENT_PROJECT_ID \
     --member="serviceAccount:SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com" \
     --role="roles/serviceusage.serviceUsageConsumer"
   
   gcloud projects add-iam-policy-binding RESOURCE_PROJECT_ID \
     --member="serviceAccount:SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com" \
     --role="roles/cloudquotas.admin"
   

   Sostituisci quanto segue:

   • CLIENT_PROJECT_ID: l'ID del progetto cliente.
   • RESOURCE_PROJECT_ID: l'ID del progetto risorsa.
   • SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com: l'indirizzo email del account di servizio.

6. Attiva il account di servizio utilizzando la chiave del account di servizio che hai creato in precedenza:

   gcloud auth activate-service-account --key-file=KEY_FILE
   

7. Abilita l'aggiustamento delle quote nel progetto di risorse specificando il progetto e l'impostazione di attivazione:

   gcloud beta quotas adjuster settings update --project=RESOURCE_PROJECT_ID \
     --enablement=enabled
   

   L'impostazione di attivazione è obbligatoria quando si utilizza gcloud CLI e deve essere impostata su enabled o disabled.

8. (Facoltativo) Per visualizzare le impostazioni correnti dell'aggiustamento delle quote, esegui questo comando:

   gcloud beta quotas adjuster settings describe --project=RESOURCE_PROJECT_ID 
   

   L'output è simile al seguente esempio:

   enablement: ENABLED
   etag: 8izmJp6EI__mOfLyhkQU9
   name: projects/RESOURCE_PROJECT_ID/locations/global/quotaAdjusterSettings
   updateTime: '2025-01-10T17:22:37.883221181Z'
   

Per abilitare l'aggiustamento delle quote per più progetti client, segui i passaggi da 5 a 8 precedenti. Quando lo fai, assicurati che siano soddisfatte le seguenti condizioni:

• L'API Cloud Quotas è abilitata nel progetto client.
• Assicurati che il account di servizio disponga del ruolo IAM cloudquotas.admin su tutti i progetti di risorse su cui vuoi attivare l'aggiustamento delle quote.

Altri servizi con comandi dell'interfaccia a riga di comando gcloud CLI correlati alla quota

Oltre a gcloud beta quotas, alcuni servizi hanno il proprio accesso da riga di comando alle informazioni su quota e 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
• La panoramica di gcloud CLI compute
• La sezione gcloud CLI compute del riferimento di Google Cloud SDK.

Passaggi successivi

• Per risolvere i problemi relativi ai comandi gcloud beta quotas, vedi Risoluzione degli errori di gcloud CLI.

• Per informazioni dettagliate sui comandi e sui flag di gcloud beta quotas, consulta la sezione gcloud beta quotas della documentazione di riferimento di Google Cloud CLI.

• Per saperne di più sulla terminologia delle quote, consulta Comprendere i valori delle quote e i limiti di sistema.