Visualizza le quote utilizzando gcloud alpha CLI

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 quotas.

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:

  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 vedi, ad esempio, il nome del servizio per Cloud Logging è 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 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 quota
  • 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 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 si verifica 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 preferita
  • QUOTA_ID: l'ID della quota
  • 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 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 è 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 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 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 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 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.