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 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:

    Seleziona la scheda relativa alla modalità di utilizzo degli esempi in questa pagina:

    Console

    Quando utilizzi la Google Cloud console per accedere a Google Cloud servizi e API, non devi configurare l'autenticazione.

    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.

  • Imposta una regione e una zona predefinite.

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

      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 Google Cloud documentazione sull'autenticazione di.

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.

Visualizzare un elenco delle zone disponibili

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

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

Console

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

Vai a Zone

gcloud

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

gcloud compute zones list

REST

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

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

Visualizzare 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 le zone AI

Se vuoi eseguire workload di 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 Zone AI.

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

Console

Nella Google Cloud console, la pagina Zone elenca le zone AI in una regione in cui queste zone sono supportate. Puoi identificare una zona AI dalla stringa AI nel nome, ad esempio la regione us-central1 elenca 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

Invia una richiesta GET al zones.list metodo. Per trovare 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 le zone AI, in cui è supportato l'acceleratore.

gcloud

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

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 cercare per tipo di acceleratore, invia una GET richiesta al acceleratorTypes.aggregatedList metodo con il filter parametro.

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 il tipo di macchina.

gcloud

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

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

  • Tipo di macchina A4 a4-highgpu-8g

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

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

      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 cercare per tipo di macchina, invia una GET richiesta al machineTypes.aggregatedList metodo con il filter parametro.

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

  • Tipo di macchina A4 a4-highgpu-8g

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

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

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

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

Escludere le zone AI dagli elenchi

Se hai accesso alle zone AI, ma non vuoi visualizzarle negli elenchi delle zone, utilizza i filtri per escluderle. Questo potrebbe essere il caso se utilizzi servizi non supportati dalle zone AI o se hai un'automazione esistente che dipende dall'elenco delle zone. Puoi identificare le zone AI dal suffisso -ai nei nomi.

gcloud

Per escludere le zone AI dall'elenco delle zone disponibili, utilizza il gcloud compute zones list comando e filtra le zone contenenti la stringa -ai:

gcloud compute zones list --filter 'name !~ ".*-ai.*"'

Per filtrare le zone AI quando elenchi i tipi di macchina, utilizza il gcloud compute machine-types list comando e filtra le zone contenenti la stringa -ai:

gcloud compute machine-types list --filter 'zone !~ ".*-ai.*"'

REST

Per escludere le zone AI dai risultati dell'API, utilizza l'espressione regolare name ne ".*-ai.*" all'interno del parametro di query del filtro. Quando aggiungi questo filtro a un URL, devi codificare il parametro di query del filtro come filter=name%20ne%20%22.%2A-ai.%2A%22.

https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones?filter=name%20ne%20%22.%2A-ai.%2A%22

Sostituisci PROJECT_ID con il tuo PROJECT_ID.

Terraform

Per escludere le zone AI dall'elenco delle zone disponibili, crea una funzione locale come nell'esempio seguente:

# Fetch zones from API
data "google_compute_zones" "available" {
  project = var.my_project_id
  region  = var.my_region
  status  = "UP"
}

locals {
  # Filter the list in Terraform
  non_ai_zones = [
    for zone in data.google_compute_zones.available.names : zone
    if !strcontains(zone, "-ai")
  ]
}

# Example usage
output "standard_gce_zones" {
  description = "List of zones, excluding AI/ML zones."
  value       = locals.non_ai_zones
}

Visualizzare un elenco delle regioni disponibili

Console

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

Vai a Zone

gcloud

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

gcloud compute regions list

Il comando elenca tutte le regioni disponibili e fornisce informazioni come le 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 delle 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 Google Cloud console.

Vai a Zone

gcloud

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

gcloud compute regions describe REGION

Una risposta sarà 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 ottenere maggiori informazioni.

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

Passaggi successivi