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 è il processo di verifica dell'identità per poter accedere a Trusted Cloud by S3NS 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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

    gcloud

    1. Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il seguente comando: 

      gcloud init
    2. Set a default region and zone.

    REST

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

      Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il seguente comando: 

      gcloud init

    Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Trusted Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare le regioni e le zone disponibili, chiedi all'amministratore di concederti il ruolo IAM Compute Viewer (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 Trusted 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

Visualizza un elenco di zone delle 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 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 ottimizzate 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 ottimizzate 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 macchina 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 Trusted 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 Trusted 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