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ù sulle regioni e sulle zone, consulta la documentazione Regioni e zone.
Per saperne di più sulle risorse Compute Engine globali, di regione e di zona, consulta la documentazione Risorse globali, di regione 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 Cloud de Confiance by S3NS . 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 al modo in cui prevedi di utilizzare gli esempi in questa pagina:
Console
Quando utilizzi la console Cloud de Confiance per accedere ai servizi e alle API Cloud de Confiance by S3NS , non devi configurare l'autenticazione.
gcloud
-
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 comando seguente:
gcloud init
-
- 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, quindi accedi a gcloud CLI con la tua identità federata.
Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Cloud de Confiance .
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 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 domanda (GPU e TPU). Queste zone specializzate sono chiamate zone AI e sono ideali per i workload di AI e ML.
Per visualizzare un elenco delle zone disponibili, incluse quelle AI, utilizza una delle seguenti opzioni:
Console
Visualizza un elenco di zone nella pagina Zone della console Cloud de Confiance .
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 che supportano gli acceleratori (GPU e TPU)
Per visualizzare un elenco di zone che supportano gli acceleratori (GPU e TPU), utilizza uno dei seguenti metodi:
- Per trovare le zone AI che forniscono una capacità significativa per gli acceleratori, cerca le zone AI.
- Per trovare tutte le zone che supportano un acceleratore specifico, esegui una ricerca per tipo di acceleratore.
- Per trovare tutte le zone che supportano un tipo di macchina specifico con un acceleratore, esegui una ricerca per tipo di macchina.
Cerca zone AI
Se vuoi eseguire workload di AI e ML, valuta l'utilizzo delle zone AI. Puoi identificare una zona AI dalla stringa ai nel suo 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 console Cloud de Confiance 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 console Cloud de Confiance , 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 suo nome, ad esempio la regione us-central1 elenca Zone AI1A.
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 le zone contenenti 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.
Cerca 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 in base al 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 in base al 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.
Cerca per tipo di macchina
La ricerca per tipo di macchina restituisce tutte le zone, incluse quelle AI, in cui questo tipo di macchina è supportato.
gcloud
Per eseguire la ricerca in base al 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 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-8ggcloud compute machine-types list \ --filter="name=a4-highgpu-8g" \ --format="value(zone)"Tipo di macchina Cloud TPU v6e (Trillium)
ct6e-standard-4tgcloud 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 una 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 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-8gGET 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-4tGET 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.
Escludi 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 accadere 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 loro nomi.
gcloud
Per escludere le zone AI dall'elenco delle zone disponibili, utilizza il comando gcloud compute zones list 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 macchine, utilizza il
comando gcloud compute machine-types list
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
}
Visualizza un elenco delle regioni disponibili
Console
Puoi visualizzare le regioni disponibili nella pagina Zone della consoleCloud de Confiance .
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 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 di regioni. Sostituisci PROJECT_ID con il tuo PROJECT_ID.
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions
Visualizza informazioni su una regione
Console
Puoi visualizzare le informazioni sulle regioni nella pagina Zone della consoleCloud de Confiance .
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
- Scopri di più su regioni e zone
- Scopri come modificare la regione o la zona predefinita
- Scopri di più sulle risorse globali, regionali e di zona