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

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

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

Le quote Cloud presentano le seguenti limitazioni:

  • Gli aggiustamenti per l'aumento della quota devono essere apportati a livello di progetto e sono soggetti all'approvazione di Google Cloud.

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

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

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 l'interfaccia a riga di comando gcloud

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

  1. Installa l'interfaccia a riga di comando gcloud.

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

  2. Inizializza 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'interfaccia a riga di comando gcloud.

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 comando seguente per elencare le informazioni sulla quota 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. Esecuzione di un comando gcloud incide sulla quota come se avessi inviato direttamente la richiesta equivalente mediante un'API REST o RPC.

      Specifica il progetto di cui vuoi utilizzare la quota. Può essere diverso dal progetto contenente il servizio per il quale stai trovando l'ID quota .

      Se hai già impostato il progetto di fatturazione durante la configurazione della CLI gcloud, questo flag è facoltativo. In caso contrario, l'omissione potrebbe causare un errore di autorizzazione negata. Per ulteriori informazioni, vedi Imposta il progetto di 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 che corrisponde a quotaId e utilizzalo quando specifichi QUOTA_ID nelle sezioni seguenti.

Comandi di esempio per le informazioni sulla quota di 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 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 --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 ti interessano ad esempio, il nome del servizio Compute Engine è compute.googleapis.com
  • PROJECT_ID_OR_NUMBER: l'ID o il numero del 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 di gcloud CLI, questo flag è facoltativo. In caso contrario, l'omissione potrebbe causare un errore di autorizzazione negata. Per ulteriori informazioni, vedi Imposta 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 il comando seguente:

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. Esecuzione di un comando gcloud incide sulla quota come se avessi inviato direttamente la richiesta equivalente mediante 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 CLI gcloud, 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.

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 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 CLI gcloud, questo flag è facoltativo. In caso contrario, l'omissione potrebbe causare un errore di autorizzazione negata. Per ulteriori informazioni, vedi Imposta il progetto di 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 CLI gcloud, questo flag è facoltativo. In caso contrario, l'omissione potrebbe causare un errore di autorizzazione negata. Per ulteriori informazioni, vedi Imposta 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 è 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 \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER --email=EMAIL --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, 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 o il numero del 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 CLI gcloud, 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 in caso Google Cloud ha bisogno di più informazioni per prendere una decisione prima è possibile concedere una quota aggiuntiva

  • PREFERENCE_ID: un ID preferenza facoltativo; se non specificare 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 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 \
    --email=EMAIL --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 update.
  • PREFERRED_VALUE: il valore della quota preferita
  • 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
  • EMAIL: un indirizzo email che può essere utilizzato come contatto in caso Google Cloud ha bisogno di più informazioni per prendere una decisione prima è possibile concedere una quota aggiuntiva

  • BILLING_PROJECT_ID_OR_NUMBER: l'ID progetto o il numero di progetto per l'utilizzo di quota e fatturazione. Esecuzione di un comando gcloud incide sulla quota come se avessi inviato direttamente la richiesta equivalente mediante un'API REST o RPC.

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

    Se hai già impostato il progetto di fatturazione durante la configurazione di 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 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 preferita
  • 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 il quale richiedi una modifica della quota.

    Se hai già impostato il progetto di fatturazione durante la configurazione della CLI gcloud, 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 per prendere una decisione prima di concedere una quota aggiuntiva

  • JUSTIFICATION: una stringa facoltativa che spiega la tua richiesta.

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

L'output conterrà dati specifici per la tua configurazione e sarebbe simile al seguente output di 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",
}

Visualizza una preferenza per la 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 di 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 gcloud CLI relativi alle quote

Oltre a gcloud alpha quotas, alcuni servizi hanno un 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