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. Zum Ausführen 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
-
Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl:
gcloud init
Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
- Set a default region and zone.
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. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl:
gcloud init
Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -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
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 ansehen
Wenn Sie eine Liste der Zonen aufrufen möchten, die GPUs unterstützen, können Sie die gcloud CLI oder REST verwenden.
gcloud
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 finden möchten, führen Sie die folgenden Befehle aus:
gcloud compute accelerator-types list --filter="nvidia-h100-80gb" gcloud compute accelerator-types list --filter="nvidia-h100-mega-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"
REST
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 finden möchten, führen Sie die folgenden Abfragen aus:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=nvidia-h100-80gb
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=nvidia-h100-mega-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 finden 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 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 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
- Mehr zu Regionen und Zonen
- Standardregion oder -zone ändern
- Mehr zu globalen, regionalen und zonalen Ressourcen