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 saperne 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 è il processo mediante il quale la tua identità viene verificata per l'accesso ai Google Cloud servizi e alle 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. After installing the Google Cloud CLI, initialize it by running the following command:

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      2. Set a default region and zone.
      3. 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.

          After installing the Google Cloud CLI, initialize it by running the following command:

          gcloud init

          If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

        Per saperne di più, consulta la sezione 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 di 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 di zone per un progetto. Sostituisci PROJECT_ID con il tuo PROJECT_ID.

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

Visualizzare 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 da 80 GB, esegui questo comando:

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

L'output restituisce un elenco di 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 macchine 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 da 80 GB, esegui questo comando:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=nvidia-h100-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 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, organizzati 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 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