Visualizza le quote utilizzando gcloud alpha CLI

Le seguenti sezioni contengono comandi di esempio gcloud alpha quotas info e gcloud alpha quotas preferences. Questi comandi 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 API di Google Cloud.

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 le quote a livello di progetto.

  • Puoi richiedere aggiustamenti delle diminuzioni delle quote per le quote a livello di project-, folder- e organizzazione.

Prima di iniziare

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

Potrebbe essere necessario anche il valore QUOTA_ID. In tal caso, consulta le istruzioni per trovare il tuo QUOTA_ID.

Installa e inizializza gcloud CLI

Per utilizzare gcloud CLI, assicurati di aver installato e iniziato la versione più recente di gcloud CLI, incluso il componente dei comandi alpha. Se utilizzi Cloud Shell per interagire con Google Cloud, gcloud CLI è installato automaticamente.

Trovare l'ID quota

Molti dei comandi dell'interfaccia a riga della gcloud CLI in questa pagina fanno riferimento al valore dell'ID quota.

Per trovare il valore dell'ID quota, utilizza il seguente comando dell'interfaccia alla gcloud CLI 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

    Sostituisci quanto segue:

    • SERVICE_NAME: il nome del servizio con le quote che vuoi visualizzare, ad esempio logging.googleapis.com

    • PROJECT_ID_OR_NUMBER: l'ID o il numero del progetto

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

      Vai a Resource Manager

  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 informazioni sui metadati e sul valore delle quote di una determinata quota per un progetto, una cartella o un'organizzazione specifici.

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 quota
  • SERVICE_NAME: il nome del servizio con le quote che vuoi visualizzare, ad esempio 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 visualizzare, ad esempio 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 i comandi gcloud alpha quotas preferences per controllare le preferenze di quota esistenti e modificare il valore di 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 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 delle quote 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

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 non è ancora stata impostata una preferenza, 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 preferita
  • QUOTA_ID: l'ID della quota
  • SERVICE_NAME: il nome del servizio con le quote che vuoi visualizzare, ad esempio logging.googleapis.com
  • PROJECT_ID_OR_NUMBER: l'ID o il numero del progetto
  • PREFERENCE_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 esiste già una 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 preferenza
  • PREFERRED_VALUE</var>"}}: il valore della quota preferita
  • QUOTA_ID: l'ID della quota
  • SERVICE_NAME: il nome del servizio con le quote che vuoi visualizzare, ad esempio 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 preferenza
  • PROJECT_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:

Passaggi successivi

Per un elenco completo dei comandi e dei flag gcloud alpha quotas, consulta la sezione gcloud alpha quote del riferimento di Google Cloud CLI.

Per ulteriori informazioni sulla terminologia relativa alle quote, consulta Comprendere i valori di quota e i limiti di sistema.