Auf dieser Seite wird beschrieben, wie Sie eine Liste der verfügbaren Regionen und Zonen aufrufen und Informationen zu einer bestimmten Region anfordern können.
Weitere Informationen finden Sie in der Dokumentation zu Regionen und Zonen.
Weitere Informationen zu globalen, regionalen und zonalen Compute Engine-Ressourcen finden Sie in der Dokumentation Globale, regionale und zonale Ressourcen.
Vorbereitung
-
Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben.
Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Cloud de Confiance by S3NS Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren:
Wählen Sie den Tab für die geplante Verwendung der Beispiele auf dieser Seite aus:
Console
Wenn Sie über die Cloud de Confiance Console auf Cloud de Confiance by S3NS Dienste und APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.
gcloud
-
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an. Nach der Anmeldung initialisieren Sie die Google Cloud CLI mit dem folgenden Befehl:
gcloud init
-
- Legen Sie eine Standardregion und -zone fest.
REST
Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an.
Weitere Informationen finden Sie in der Dokumentation zur Cloud de Confiance -Authentifizierung unter Für die Verwendung von REST authentifizieren.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-Betrachter (roles/compute.viewer) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen der verfügbaren Regionen und Zonen benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Liste der verfügbaren Zonen ansehen
Eine Zone ist ein Bereitstellungsbereich innerhalb einer Region. In einigen Regionen gibt es spezielle Zonen, die eine erhebliche Kapazität für stark nachgefragte Beschleuniger (GPUs und TPUs) bieten. Diese speziellen Zonen werden als KI-Zonen bezeichnet und sind ideal für KI- und ML-Arbeitslasten.
Eine Liste der verfügbaren Zonen, einschließlich der KI-Zonen, können Sie auf eine der folgenden Arten aufrufen:
Console
Rufen Sie eine Liste der Zonen auf der Seite Zonen in der Cloud de Confiance Console auf.
gcloud
Führen Sie über die Google Cloud CLI den Befehl gcloud compute zones list aus:
gcloud compute zones list
REST
Stellen Sie eine GET-Anfrage an die Methode zones.list, um eine Liste der Zonen für ein Projekt abzurufen. Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID.
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones
Liste der Zonen mit Unterstützung für Beschleuniger (GPUs und TPUs) ansehen
Verwenden Sie eine der folgenden Methoden, um eine Liste der Zonen aufzurufen, die Beschleuniger (GPUs und TPUs) unterstützen:
- Suchen Sie nach KI-Zonen, die eine hohe Kapazität für Beschleuniger bieten.
- Wenn Sie alle Zonen finden möchten, die einen bestimmten Beschleuniger unterstützen, suchen Sie nach Beschleunigertyp.
- Wenn Sie alle Zonen finden möchten, die einen bestimmten Maschinentyp mit einem Beschleuniger unterstützen, suchen Sie nach Maschinentyp.
Nach KI-Zonen suchen
Wenn Sie KI- und ML-Arbeitslasten ausführen möchten, sollten Sie KI-Zonen verwenden. Sie erkennen eine KI-Zone am String ai im Namen. us-central1-ai1a ist beispielsweise eine KI-Zone in der Region us-central1 mit us-central1-a als übergeordneter Zone. Weitere Informationen finden Sie unter KI-Zonen.
In der Cloud de Confiance -Konsole werden KI-Zonen zusammen mit anderen Zonen nach Regionen gruppiert aufgeführt. Verwenden Sie die gcloud CLI oder die REST API, um eine Liste der verfügbaren KI-Zonen aufzurufen.
Console
Auf der Seite Zonen in der Cloud de Confiance Console werden die KI-Zonen in einer Region aufgeführt, in der diese Zonen unterstützt werden. Sie erkennen eine KI-Zone am String AI in ihrem Namen, z. B. Zone AI1A in der Region us-central1.
gcloud
Verwenden Sie den Befehl gcloud compute zones list und filtern Sie Zonen, die den String ai enthalten:
gcloud compute zones list \
--filter="name~'-ai'"
REST
Stellen Sie eine GET-Anfrage an die Methode zones.list. Wenn Sie Zonen abgleichen möchten, deren Name ai enthält, verwenden Sie den Abfrageparameter filter mit dem regulären Ausdruck name eq '.*-ai.*'.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones?filter=name%20eq%20'.*-ai.*'
Ersetzen Sie PROJECT_ID durch Ihre PROJECT_ID.
Nach Beschleunigertyp suchen
Wenn Sie nach einem Beschleunigertyp suchen, werden alle Zonen zurückgegeben, in denen dieser Beschleuniger unterstützt wird, einschließlich KI-Zonen.
gcloud
Verwenden Sie den Befehl gcloud compute accelerator-types list mit dem Flag --filter, um nach Beschleunigertyp zu suchen.
Wenn Sie beispielsweise alle Zonen mit einem bestimmten Beschleuniger wie einer NVIDIA B200-GPU oder einer Cloud TPU v6e (Trillium) finden möchten, führen Sie einen der folgenden Befehle aus:
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)"
Ersetzen Sie den Beschleunigertyp im Beispiel durch den Beschleunigertyp, nach dem Sie suchen möchten.
REST
Wenn Sie nach Beschleunigertyp suchen möchten, senden Sie eine GET-Anfrage an die Methode acceleratorTypes.aggregatedList mit dem Parameter filter.
Wenn Sie beispielsweise alle Zonen mit einem bestimmten Hardwarebeschleuniger wie einer NVIDIA B200-GPU oder einer Cloud TPU v6e (Trillium) finden möchten, führen Sie einen der folgenden Befehle aus:
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
Ersetzen Sie den Beschleunigertyp im Beispiel durch den Beschleunigertyp, nach dem Sie suchen möchten.
Nach Maschinentyp suchen
Wenn Sie nach einem Maschinentyp suchen, werden alle Zonen zurückgegeben, einschließlich KI-Zonen, in denen dieser Maschinentyp unterstützt wird.
gcloud
Verwenden Sie zum Suchen nach Maschinentyp den Befehl gcloud compute machine-types list mit dem Flag --filter.
Wenn Sie beispielsweise alle Zonen mit einem bestimmten Maschinentyp wie dem Maschinentyp a4-highgpu-8g A4 oder dem Maschinentyp ct6e-standard-4t Cloud TPU v6e (Trillium) finden möchten, führen Sie einen der folgenden Befehle aus:
a4-highgpu-8gA4-Maschinentypgcloud compute machine-types list \ --filter="name=a4-highgpu-8g" \ --format="value(zone)"ct6e-standard-4tCloud TPU v6e-Maschinentyp (Trillium)gcloud compute machine-types list \ --filter="name=ct6e-standard-4t" \ --format="value(zone)"
Ersetzen Sie den Maschinentyp im Beispiel durch den Maschinentyp, nach dem Sie suchen möchten.
REST
Wenn Sie nach Maschinentyp suchen möchten, stellen Sie eine GET-Anfrage an die Methode machineTypes.aggregatedList mit dem Parameter filter.
Wenn Sie beispielsweise alle Zonen mit einem bestimmten Maschinentyp wie dem Maschinentyp a4-highgpu-8g A4 oder dem Maschinentyp ct6e-standard-4t Cloud TPU v6e (Trillium) finden möchten, führen Sie einen der folgenden Befehle aus:
a4-highgpu-8gA4-MaschinentypGET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a4-highgpu-8g
ct6e-standard-4tCloud TPU v6e-Maschinentyp (Trillium)GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=ct6e-standard-4t
Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID und den Maschinentyp durch den Maschinentyp, nach dem Sie suchen möchten.
KI-Zonen aus Listen ausschließen
Wenn Sie Zugriff auf KI-Zonen haben, diese aber nicht in Ihren Zonenlisten sehen möchten, können Sie sie mit Filtern ausschließen. Das kann der Fall sein, wenn Sie Dienste verwenden, die von KI-Zonen nicht unterstützt werden, oder wenn Sie eine vorhandene Automatisierung haben, die von der Liste der Zonen abhängt. KI-Zonen haben das Suffix -ai in ihren Namen.
gcloud
Wenn Sie KI-Zonen aus der Liste der verfügbaren Zonen ausschließen möchten, verwenden Sie den Befehl gcloud compute zones list und filtern Sie Zonen, die den String -ai enthalten:
gcloud compute zones list --filter 'name !~ ".*-ai.*"'
Wenn Sie beim Auflisten von Maschinentypen KI-Zonen herausfiltern möchten, verwenden Sie den Befehl gcloud compute machine-types list und filtern Sie Zonen, die den String -ai enthalten:
gcloud compute machine-types list --filter 'zone !~ ".*-ai.*"'
REST
Wenn Sie KI-Zonen aus API-Ergebnissen ausschließen möchten, verwenden Sie den regulären Ausdruck name ne ".*-ai.*" im Abfrageparameter „filter“. Wenn Sie diesen Filter in eine URL einfügen, müssen Sie den Filterabfrageparameter als filter=name%20ne%20%22.%2A-ai.%2A%22 codieren.
https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones?filter=name%20ne%20%22.%2A-ai.%2A%22
Ersetzen Sie PROJECT_ID durch Ihre PROJECT_ID.
Terraform
Wenn Sie KI-Zonen aus der Liste der verfügbaren Zonen ausschließen möchten, erstellen Sie eine lokale Funktion wie im folgenden Beispiel:
# 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
}
Liste der verfügbaren Regionen aufrufen
Console
Die verfügbaren Regionen finden Sie in derCloud de Confiance Console auf der Seite Zonen.
gcloud
Führen Sie über die Google Cloud CLI den Befehl gcloud compute regions list aus:
gcloud compute regions list
Durch den Befehl werden alle verfügbaren Regionen aufgelistet und Informationen wie etwa Kontingente und der Status der Region bereitgestellt.
Beispiel:
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
Senden Sie eine GET-Anfrage an die Methode regions.list, um eine Liste der Regionen abzurufen. Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID.
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions
Informationen zu einer Region ansehen
Console
Auf der Seite Zonen in derCloud de Confiance Console erhalten Sie Informationen zu Regionen.
gcloud
Um Informationen zu einer einzelnen Region abzurufen, führen Sie den Befehl gcloud compute
regions describe aus. Dabei ist REGION der Name der Region, über die Sie weitere Informationen abrufen möchten:
gcloud compute regions describe REGION
Die Antwort würde so oder ähnlich aussehen:
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
Stellen Sie eine GET-Anfrage an die Methode regions.get, um Informationen zu einer Region abzurufen. Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID und REGION durch die Region, über die Sie mehr erfahren möchten.
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION