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.
Hinweise
-
Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben.
Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud-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 Verwendung der Beispiele auf dieser Seite aus:
Console
Wenn Sie über die Google Cloud Console auf Google Cloud-Dienste und -APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.
gcloud
-
Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:
gcloud init
- Legen Sie eine Standardregion und -zone fest.
REST
Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.
Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:
gcloud init
-
Erforderliche Rollen
Um die Berechtigungen zu erhalten, die Sie zum Aufrufen der verfügbaren Regionen und Zonen benötigen, bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-Betrachter (roles/compute.viewer
) für das Projekt zuzuweisen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Liste der verfügbaren Zonen aufrufen
Console
Rufen Sie eine Liste der Zonen auf der Seite "Zonen" in der Google Cloud 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 GPU-Zonen aufrufen
Zum Aufrufen einer Liste der Zonen, die GPUs unterstützen, können Sie die gcloud CLI oder REST verwenden.
gcloud
Nach GPU-Typ suchen
Verwenden Sie für die Suche nach GPU-Typ den Befehl gcloud compute accelerator-types list
mit dem Flag --filter
, um verfügbare Zonen zu finden.
Führen Sie beispielsweise den folgenden Befehl aus, um alle Zonen mit H100-80GB-GPUs zu ermitteln:
gcloud compute accelerator-types list --filter="nvidia-h100-80gb"
Die Ausgabe gibt eine Liste von verfügbaren GPUs zurück, sortiert nach Zone. Mit dem Befehl gcloud compute accelerator-types describe
können Sie dann eine Beschreibung von jedem zurückgegebenen GPU-Modell abrufen.
Nach Maschinentyp suchen
Bei beschleunigungsoptimierten Maschinentypen A3, A2 oder G2 werden GPUs automatisch an die VMs angehängt.
Für diese Maschinentypen können Sie den Befehl gcloud compute machine-types list
mit dem Flag --filter
verwenden, um verfügbare Zonen zu finden. Führen Sie beispielsweise den folgenden Befehl aus, um alle Zonen mit A3-Standard-Maschinentypen zu ermitteln:
gcloud compute machine-types list --filter="name=a3-highgpu-8g"
REST
Nach GPU-Typ suchen
Um die verfügbaren Zonen für ein bestimmtes GPU-Modell aufzurufen, senden Sie eine GET
-Anfrage mit dem Parameter --filter
an die Methode acceleratorTypes.aggregatedList
.
Führen Sie beispielsweise den folgenden Befehl aus, um alle Zonen mit H100-80GB-GPUs zu ermitteln:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=nvidia-h100-80gb
Nach Maschinentyp suchen
Bei beschleunigungsoptimierten Maschinentypen A3, A2 oder G2 werden GPUs automatisch an die VMs angehängt.
Für diese Maschinentypen können Sie die Methode machineTypes.aggregatedList
mit dem Parameter --filter
verwenden, um verfügbare Zonen zu finden.
Führen Sie beispielsweise den folgenden Befehl aus, um alle Zonen mit A3-Standard-Maschinentypen zu ermitteln:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a3-higgpu-8
Ersetzen Sie PROJECT_ID
durch Ihre Projekt-ID.
Die Ausgabe gibt eine Liste der verfügbaren GPUs und eine Beschreibung jedes GPU-Modells zurück, sortiert nach Zone.
Liste der verfügbaren Regionen aufrufen
Console
Rufen Sie eine Liste der Regionen auf der Seite "Zonen" in der Google Cloud Console auf.
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 aufrufen
Console
Auf der Seite "Zonen" in der Google Cloud 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
Nächste Schritte
- Weitere Informationen zu Regionen und Zonen
- Standardregion oder -zone ändern
- Mehr zu globalen, regionalen und zonalen Ressourcen