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 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.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Mehr zu Regionen und Zonen
- Standardregion oder -zone ändern
- Mehr zu globalen, regionalen und zonalen Ressourcen
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
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 Methodezones.list
, um eine Liste der Zonen für ein Projekt abzurufen. Ersetzen SiePROJECT_ID
durch Ihre PROJECT_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. 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"
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 MethodeacceleratorTypes.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.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 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 Methoderegions.list
, um eine Liste der Regionen abzurufen. Ersetzen SiePROJECT_ID
durch Ihre PROJECT_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 istREGION
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 Methoderegions.get
, um Informationen zu einer Region abzurufen. Ersetzen SiePROJECT_ID
durch Ihre PROJECT_ID undREGION
durch die Region, über die Sie mehr erfahren möchten.https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION
Nächste Schritte
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-12-03 (UTC).
-