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 bei Compute Engine authentifizieren. Wählen Sie dazu eine der folgenden Optionen aus:
Select the tab for how you plan to use the samples on this page:
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
REST
Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.
-
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 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 aufrufen
Rufen Sie eine Liste der Zonen auf der Seite "Zonen" in der Google Cloud Console auf.
Führen Sie über die Google Cloud CLI den Befehl gcloud compute zones list
aus:
gcloud compute zones list
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 ansehen
Eine Liste der Zonen, die GPUs unterstützen, können Sie mit der gcloud CLI oder REST aufrufen.
Nach GPU-Typ suchen
Wenn Sie nach GPU-Typ suchen möchten, verwenden Sie den Befehl gcloud compute accelerator-types list
mit dem Flag --filter
, um verfügbare Zonen zu finden.
Wenn Sie beispielsweise alle Zonen mit H100-GPUs mit 80 GB finden möchten, führen Sie den folgenden Befehl aus:
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 A3-, A2- oder G2-Maschinentypen 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. Wenn Sie beispielsweise alle Zonen mit A3 High-Maschinentypen ermitteln möchten, führen Sie den folgenden Befehl aus:
gcloud compute machine-types list --filter="name=a3-highgpu-8g"
Nach GPU-Typ suchen
Wenn Sie die verfügbaren Zonen für ein bestimmtes GPU-Modell aufrufen möchten, senden Sie eine GET
-Anfrage an die acceleratorTypes.aggregatedList
-Methode mit dem Parameter --filter
.
Wenn Sie beispielsweise alle Zonen mit H100-GPUs mit 80 GB finden möchten, führen Sie den folgenden Befehl aus:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /aggregated/acceleratorTypes?filter=name=nvidia-h100-80gb
Nach Maschinentyp suchen
Bei beschleunigungsoptimierten A3-, A2- oder G2-Maschinentypen 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.
Wenn Sie beispielsweise alle Zonen mit A3 High-Maschinentypen ermitteln möchten, führen Sie den folgenden Befehl aus:
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 der einzelnen GPU-Modelle zurück, sortiert nach Zone.
Liste der verfügbaren Regionen aufrufen
Rufen Sie eine Liste der Regionen auf der Seite "Zonen" in der Google Cloud Console auf.
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
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
Auf der Seite "Zonen" in der Google Cloud Console erhalten Sie Informationen zu Regionen.
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 describeREGION
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
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
- Mehr zu Regionen und Zonen
- Standardregion oder -zone ändern
- Mehr zu globalen, regionalen und zonalen Ressourcen