Visualizzare e gestire le quote utilizzando l'interfaccia a riga di comando gcloud alpha

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

Puoi utilizzare Google Cloud CLI (gcloud CLI) per recuperare i valori delle quote attuali e specificare le preferenze relative alle quote per alcuni servizi e alcune API Google Cloud.

Limitazioni

Le quote Cloud presentano le seguenti limitazioni:

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

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

  • L'API Cloud Quotas supporta solo le operazioni a livello di progetto. Le operazioni a livello di cartella e di organizzazione non sono supportate.

  • Nella console Google Cloud, la pagina Quote e limiti di sistema non supporta la selezione di regioni o zone per le richieste di aggiustamento delle quote dal pulsante Modifica. Per modificare le quote a livello regionale o zonale nella console Google Cloud, consulta le istruzioni su come richiedere una quota più alta.

Prima di iniziare

Prima di utilizzare gcloud CLI, assicurati di installare e inizializzare gcloud CLI.

Potresti anche aver bisogno del valore QUOTA_ID. In questo caso, consulta le istruzioni per trovare l'ID quota.

Installa e inizializza la gcloud CLI

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

  1. Installa la gcloud CLI.

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

  2. Inizializza la gcloud CLI.

  3. Installa il componente alpha eseguendo il seguente comando:

    gcloud components install alpha

Trovare l'ID quota

Diversi comandi dell'interfaccia a riga di comando gcloud in questa pagina fanno riferimento al valore 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 l&#gcloud CLI.

Console

  1. Vai alla pagina Quote e Limiti di sistema:

    Vai a Quote e Limiti di sistema

  2. Fai clic su Filtra per filtrare in base al servizio.

  3. Se non vedi la colonna Nome limite, fai clic sull'icona Opzioni di visualizzazione delle colonne. Seleziona Nome limite e fai clic su OK.

  4. La colonna Nome limite mostra l'ID quota.

gcloud

Per trovare il valore dell'ID quota utilizzando gcloud CLI, esegui il seguente comando per elencare le informazioni sulle quote per il servizio specificato:

  1. Inserisci il seguente comando gcloud CLI in una finestra del terminale:

    gcloud alpha quotas info list --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
--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

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

      Per trovare l'ID progetto utilizzando la console Google Cloud, vai alla pagina Resource Manager:

      Vai a Resource Manager

    • 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 cercando l'ID quota.

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

  2. 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"
                ]
                ...
            }
        ]
    },
    ...
]
...

  3. Cerca il valore corrispondente a quotaId e utilizzalo quando specifichi QUOTA_ID nelle sezioni seguenti.

Comandi di esempio per informazioni sulle quote gcloud

Questa sezione fornisce esempi che mostrano come utilizzare i comandi gcloud alpha quotas info per visualizzare le informazioni sulle quote per un determinato servizio o per un'organizzazione.

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

Visualizzare le informazioni sulla quota per un determinato servizio

Per visualizzare le informazioni sulle quote per un determinato servizio, esegui il seguente comando:

gcloud alpha 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, consulta 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 sulle quote.

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

Visualizzare le informazioni sulla quota per un'organizzazione

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

gcloud alpha 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 sulle quote.

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

Esempi di comandi gcloud quota preferences

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

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

Controllare se esistono preferenze esistenti

Per verificare la presenza di preferenze esistenti, esegui il seguente comando:

gcloud alpha 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 relative alle quote.

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

Controllare se esistono preferenze 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 alpha 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 relative alle quote.

    Se hai già impostato il progetto di fatturazione durante la configurazione della gcloud CLI, questo flag è facoltativo. In caso contrario, l'omissione potrebbe causare un errore di autorizzazione negata. Per ulteriori informazioni, consulta la sezione Impostare il progetto 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 non è ancora stata impostata una preferenza, esegui il seguente comando:

gcloud alpha 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 preferito
  • QUOTA_ID: il valore dell'ID quota. Per trovare questo valore, consulta 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 richiedi una modifica della quota.

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

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

  • JUSTIFICATION: una stringa facoltativa che spiega la richiesta

  • PREFERENCE_ID: un ID preferenza facoltativo. Se non specifichi un ID preferenza, l'API genera un UUID (Universally Unique Identifier)

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 ed esiste già una preferenza, esegui il seguente comando:

gcloud alpha 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 alpha quotas preferences update.
  • PREFERRED_VALUE: il valore della quota preferito
  • QUOTA_ID: il valore dell'ID quota. Per trovare questo valore, consulta 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 richiedi una modifica della quota.

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

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

  • JUSTIFICATION: una stringa facoltativa che spiega la richiesta

Richiedere un aggiustamento dell'aumento della quota utilizzando una dimensione

Per richiedere un aggiustamento dell'aumento della quota utilizzando una dimensione, esegui il seguente comando:

gcloud alpha 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 preferito
  • QUOTA_ID: il valore dell'ID quota. Per trovare questo valore, consulta 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 di coppie chiave-valore separato da virgole. 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 richiedi una modifica della quota.

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

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

  • JUSTIFICATION: una stringa facoltativa che spiega la richiesta

  • PREFERENCE_ID: un ID preferenza facoltativo. Se non specifichi un ID preferenza, l'API genera un UUID (Universally Unique Identifier)

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 il seguente comando:

gcloud alpha 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 alpha 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 della gcloud CLI, questo flag è facoltativo. In caso contrario, l'omissione potrebbe causare un errore di autorizzazione negata. Per ulteriori informazioni, consulta la sezione Impostare il progetto 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'

Altri servizi con comandi dell'interfaccia a riga di comando gcloud CLI relativi alle quote

Oltre a gcloud alpha 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:

Passaggi successivi