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 Compute Engine globali, di regione 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 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 a come prevedi di utilizzare gli esempi in questa pagina:
Console
Quando utilizzi la console Cloud de Confiance per accedere ai servizi Cloud de Confiance by S3NS e alle API, 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 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
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 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 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 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 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:
- Per trovare zone AI che offrono una capacità significativa per gli acceleratori, cerca le zone AI.
- Per trovare tutte le zone che supportano un acceleratore specifico, cerca per tipo di acceleratore.
- Per trovare tutte le zone che supportano un tipo di macchina specifico con un acceleratore, esegui la ricerca per tipo di macchina.
Cercare 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 console Cloud de Confiance elenca le zone AI insieme alle 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 sono supportate. Puoi identificare una zona AI dalla stringa AI nel nome, ad esempio us-central1 elenca le regioni 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 corrispondenze con 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 quelle AI, in cui l'acceleratore è supportato.
gcloud
Per eseguire la ricerca per 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 per 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.
Eseguire ricerche per tipo di macchina
La ricerca per tipo di macchina restituisce tutte le zone, comprese quelle AI, in cui è supportato quel tipo di macchina.
gcloud
Per eseguire la ricerca per 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-highgpu-8g A4 o il tipo di macchina ct6e-standard-4t Cloud TPU v6e
(Trillium), esegui uno dei seguenti comandi:
a4-highgpu-8gTipo di macchina A4gcloud compute machine-types list \ --filter="name=a4-highgpu-8g" \ --format="value(zone)"ct6e-standard-4tTipo di macchina Cloud TPU v6e (Trillium)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 eseguire la 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-highgpu-8g A4 o il tipo di macchina ct6e-standard-4t Cloud TPU v6e
(Trillium), esegui uno dei seguenti comandi:
a4-highgpu-8gTipo di macchina A4GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a4-highgpu-8g
ct6e-standard-4tTipo di macchina Cloud TPU v6e (Trillium)GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=ct6e-standard-4t
Sostituisci PROJECT_ID con il tuo 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 verificarsi 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 macchina, 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 console Cloud 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 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 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 di più su come modificare la regione o la zona predefinita.
- Scopri di più sulle risorse globali, regionali e di zona