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 a Google Cloud servizi e API. 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 seguente comando:

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla 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 fornite a gcloud CLI.

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

      gcloud init

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

    Per saperne di più, consulta Autenticarsi per l'utilizzo di 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

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 di zone GPU

Per visualizzare un elenco delle zone che supportano le GPU, puoi utilizzare gcloud CLI o REST.

gcloud

Ricerca per tipo di GPU

Per eseguire la ricerca per tipo di GPU, utilizza il comando gcloud compute accelerator-types list con il flag --filter per trovare le zone disponibili.

Ad esempio, per trovare tutte le zone con GPU H100, esegui i seguenti comandi:

gcloud compute accelerator-types list --filter="nvidia-h100-80gb"
gcloud compute accelerator-types list --filter="nvidia-h100-mega-80gb"

L'output restituisce un elenco delle GPU disponibili organizzate per zona. Puoi quindi utilizzare il comando gcloud compute accelerator-types describe per ottenere una descrizione di ogni modello di GPU restituito.

Ricerca per tipo di macchina

I tipi di macchine A3, A2 o G2 ottimizzati per l'acceleratore hanno GPU collegate automaticamente alle VM. Per questi tipi di macchine, puoi utilizzare il comando gcloud compute machine-types list con il flag --filter per trovare le zone disponibili. Ad esempio, per trovare tutte le zone con tipi di macchina A3 High, esegui il seguente comando:

gcloud compute machine-types list --filter="name=a3-highgpu-8g"

REST

Ricerca per tipo di GPU

Per visualizzare le zone disponibili per un modello di GPU specifico, invia una richiesta GET al metodo acceleratorTypes.aggregatedList con il parametro --filter .

Ad esempio, per trovare tutte le zone con GPU H100, esegui le seguenti query:

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

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=nvidia-h100-mega-80gb

Ricerca per tipo di macchina

I tipi di macchine A3, A2 o G2 ottimizzati per l'acceleratore hanno GPU collegate automaticamente alle VM. Per questi tipi di macchine, puoi utilizzare il metodo machineTypes.aggregatedList con il parametro --filter per trovare le zone disponibili.

Ad esempio, per trovare tutte le zone con i tipi di macchine A3 High, esegui il seguente comando:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a3-higgpu-8

Sostituisci PROJECT_ID con l'ID progetto.

L'output restituisce un elenco delle GPU disponibili e una descrizione di ciascun modello di GPU, organizzato per zona.

Visualizzare un elenco delle regioni disponibili

Console

Visualizza un elenco delle regioni 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 le informazioni sulle regioni nella pagina Zone della console Google 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 per 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