Visualizza le regioni e le zone disponibili

Questa pagina spiega come visualizzare un elenco delle regioni e delle zone disponibili e come ottenere informazioni su una regione specifica.

Per scoprire di più su regioni e zone, consulta la documentazione Regioni e zone.

Per saperne di più sulle risorse di Compute Engine globali, regionali e di zona, consulta la documentazione Risorse globali, regionali e di zona.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso ad API e servizi Google Cloud . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    2. Set a default region and zone.

    REST

    Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

      Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare le regioni e le zone disponibili, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore Compute (roles/compute.viewer) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Visualizza un elenco delle zone disponibili

Una zona è un'area di deployment all'interno di una regione. Alcune regioni dispongono di zone specializzate che forniscono una capacità significativa per gli acceleratori ad alta richiesta (GPU e TPU). Queste zone specializzate sono chiamate zone AI e sono ideali per i workload AI e ML.

Per visualizzare un elenco delle zone disponibili, incluse le zone AI, utilizza una delle seguenti opzioni:

Console

Visualizza un elenco di zone nella pagina Zone della console Google Cloud .

Vai a Zone

gcloud

Utilizzando Google Cloud CLI, esegui il comando gcloud compute zones list:

gcloud compute zones list

REST

Invia una richiesta GET al metodo zones.list per ottenere un elenco delle zone per un progetto. Sostituisci PROJECT_ID con il tuo PROJECT_ID.

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones

Visualizza un elenco delle zone che supportano gli acceleratori (GPU e TPU)

Per visualizzare un elenco delle zone che supportano gli acceleratori (GPU e TPU), utilizza uno dei seguenti metodi:

Cercare zone AI

Se vuoi eseguire workload AI e ML, valuta la possibilità di utilizzare le zone AI. Puoi identificare una zona AI dalla stringa ai nel nome. Ad esempio, us-central1-ai1a è una zona AI nella regione us-central1, con us-central1-a come zona principale. Per saperne di più, consulta Zona AI.

La console Google Cloud elenca le zone AI insieme alle altre zone, raggruppate per regioni. Per visualizzare un elenco delle zone AI disponibili, utilizza gcloud CLI o l'API REST.

Console

Nella console Google Cloud , la pagina Zone elenca le zone AI in una regione in cui sono supportate. Puoi identificare una zona AI dalla stringa AI nel nome, ad esempio us-central1 elenchi di regioni Zone AI1A.

Vai a Zone

gcloud

Utilizza il comando gcloud compute zones list e filtra le zone contenenti la stringa ai:

gcloud compute zones list \
    --filter="name~'-ai'"

REST

Effettua una richiesta GET al metodo zones.list. Per trovare corrispondenze con le zone che contengono ai nel nome, utilizza il parametro di query filter con l'espressione regolare name eq '.*-ai.*'.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones?filter=name%20eq%20'.*-ai.*'

Sostituisci PROJECT_ID con il tuo PROJECT_ID.

Cercare per tipo di acceleratore

La ricerca per tipo di acceleratore restituisce tutte le zone, incluse quelle AI, in cui l'acceleratore è supportato.

gcloud

Per eseguire la ricerca per tipo di acceleratore, utilizza il comando gcloud compute accelerator-types list con il flag --filter.

Ad esempio, per trovare tutte le zone con un acceleratore specifico come una GPU NVIDIA B200 o una Cloud TPU v6e (Trillium), esegui uno dei seguenti comandi:

  • NVIDIA B200

      gcloud compute accelerator-types list \
      --filter="name=nvidia-b200" \
      --format="value(zone)"

  • Cloud TPU v6e (Trillium)

      gcloud compute accelerator-types list \
      --filter="name=ct6e" \
      --format="value(zone)"

Sostituisci il tipo di acceleratore nell'esempio con il tipo di acceleratore in base al quale vuoi eseguire la ricerca.

REST

Per eseguire la ricerca per tipo di acceleratore, invia una richiesta GET al metodo acceleratorTypes.aggregatedList con il parametro filter.

Ad esempio, per trovare tutte le zone con un acceleratore specifico come una GPU NVIDIA B200 o una Cloud TPU v6e (Trillium), esegui uno dei seguenti comandi:

  • NVIDIA B200 

      GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=nvidia-b200

  • Cloud TPU v6e (Trillium) 

      GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=ct6e

Sostituisci il tipo di acceleratore nell'esempio con il tipo di acceleratore in base al quale vuoi eseguire la ricerca.

Cercare per tipo di macchina

La ricerca per tipo di macchina restituisce tutte le zone, incluse le zone AI, in cui è supportato quel tipo di macchina.

gcloud

Per eseguire la ricerca per tipo di macchina, utilizza il comando gcloud compute machine-types list con il flag --filter.

Ad esempio, per trovare tutte le zone con un tipo di macchina specifico come il tipo di macchina a4-highgpu-8g A4 o il tipo di macchina ct6e-standard-4t Cloud TPU v6e (Trillium), esegui uno dei seguenti comandi:

  • a4-highgpu-8g Tipo di macchina A4

      gcloud compute machine-types list \
      --filter="name=a4-highgpu-8g" \
      --format="value(zone)"

  • ct6e-standard-4t Tipo di macchina Cloud TPU v6e (Trillium)

      gcloud compute machine-types list \
      --filter="name=ct6e-standard-4t" \
      --format="value(zone)"

Sostituisci il tipo di macchina nell'esempio con il tipo di macchina in base al quale vuoi eseguire la ricerca.

REST

Per eseguire la ricerca per tipo di macchina, invia una richiesta GET al metodo machineTypes.aggregatedList con il parametro filter.

Ad esempio, per trovare tutte le zone con un tipo di macchina specifico come il tipo di macchina a4-highgpu-8g A4 o il tipo di macchina ct6e-standard-4t Cloud TPU v6e (Trillium), esegui uno dei seguenti comandi:

  • a4-highgpu-8g Tipo di macchina A4

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a4-highgpu-8g

  • ct6e-standard-4t Tipo di macchina Cloud TPU v6e (Trillium)

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=ct6e-standard-4t

Sostituisci PROJECT_ID con il tuo ID progetto e il tipo di macchina con il tipo di macchina in base al quale vuoi eseguire la ricerca.

Visualizza un elenco delle regioni disponibili

Console

Puoi visualizzare le regioni disponibili nella pagina Zone della console Google Cloud .

Vai a Zone

gcloud

Utilizzando Google Cloud CLI, esegui il comando gcloud compute regions list:

gcloud compute regions list

Il comando elenca tutte le regioni disponibili e fornisce informazioni come quote e lo stato della regione stessa.

Ad esempio:

gcloud compute regions list
NAME             CPUS   DISKS_GB     ADDRESSES  RESERVED_ADDRESSES  STATUS
asia-east1       0/24   0/10240           0/23       0/7                 UP
asia-northeast1  0/24   0/10240           0/23       0/7                 UP
asia-southeast1  0/24   0/10240           0/23       0/7                 UP
europe-west1     0/24   0/10240           2/23       0/7                 UP
us-central1      0/24   0/10240           0/23       0/7                 UP
us-east1         0/24   0/10240           0/23       0/7                 UP
us-west1         0/24   0/10240           0/23       0/7                 UP

REST

Invia una richiesta GET al metodo regions.list per ottenere un elenco di regioni. Sostituisci PROJECT_ID con il tuo PROJECT_ID.

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions

Visualizzare informazioni su una regione

Console

Puoi visualizzare informazioni sulle regioni nella pagina Zone della consoleGoogle Cloud .

Vai a Zone

gcloud

Per ottenere informazioni su una singola regione, esegui il comando gcloud compute regions describe, dove REGION è il nome della regione su cui vuoi ottenere maggiori informazioni:

gcloud compute regions describe REGION

Una risposta sarebbe simile alla seguente:

creationTimestamp: '2013-09-06T17:54:12.193-07:00'
description: us-central1
id: '5778272079688511892'
kind: compute#region
name: us-central1
quotas:
- limit: 24.0
    metric: CPUS
    usage: 5.0
- limit: 5120.0
    metric: DISKS_TOTAL_GB
    usage: 650.0
- limit: 7.0
    metric: STATIC_ADDRESSES
    usage: 4.0
- limit: 23.0
    metric: IN_USE_ADDRESSES
    usage: 5.0
- limit: 1024.0
    metric: SSD_TOTAL_GB
    usage: 0.0
selfLink: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/us-central1
status: UP
zones:
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-b
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-c
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-f

REST

Invia una richiesta GET al metodo regions.get per ottenere informazioni su una regione. Sostituisci PROJECT_ID con il tuo PROJECT_ID e REGION con la regione su cui vuoi maggiori informazioni.

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION

Passaggi successivi