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 der 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 initWenn 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 initWenn 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
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 spezialisierten Zonen werden als KI-Zonen bezeichnet und sind ideal für KI- und ML-Arbeitslasten.
Wenn Sie eine Liste der verfügbaren Zonen, einschließlich der KI-Zonen, aufrufen möchten, haben Sie folgende Möglichkeiten:
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 listaus: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_IDdurch 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, um KI-Zonen mit erheblicher Kapazität für Beschleuniger zu finden.
- 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
aiin ihrem Namen.us-central1-ai1aist beispielsweise eine KI-Zone in der Regionus-central1mitus-central1-aals übergeordneter Zone. Weitere Informationen zur KI-ZoneIn der Google Cloud -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 Google Cloud Console werden die KI-Zonen in einer Region aufgeführt, in der diese Zonen unterstützt werden. Sie erkennen eine KI-Zone am String
AIim Namen, z. B.Zone AI1Ain der Regionus-central1.gcloud
Verwenden Sie den Befehl
gcloud compute zones listund filtern Sie Zonen, die den Stringaienthalten:gcloud compute zones list \ --filter="name~'-ai'"REST
Stellen Sie eine
GET-Anfrage an die Methodezones.list. Wenn Sie Zonen abgleichen möchten, deren Nameaienthält, verwenden Sie den Abfrageparameterfiltermit dem regulären Ausdruckname eq '.*-ai.*'.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones?filter=name%20eq%20'.*-ai.*'
Ersetzen Sie
PROJECT_IDdurch 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 listmit 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 MethodeacceleratorTypes.aggregatedListmit dem Parameterfilter.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 listmit dem Flag--filter.Wenn Sie beispielsweise alle Zonen mit einem bestimmten Maschinentyp wie dem Maschinentyp
a4-highgpu-8gA4 oder dem Maschinentypct6e-standard-4tCloud 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 MethodemachineTypes.aggregatedListmit dem Parameterfilter.Wenn Sie beispielsweise alle Zonen mit einem bestimmten Maschinentyp wie dem Maschinentyp
a4-highgpu-8gA4 oder dem Maschinentypct6e-standard-4tCloud 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_IDdurch Ihre Projekt-ID und den Maschinentyp durch den Maschinentyp, nach dem Sie suchen möchten.Liste der verfügbaren Regionen aufrufen
Console
Die verfügbaren Regionen finden Sie in derGoogle Cloud Console auf der Seite Zonen.
gcloud
Führen Sie über die Google Cloud CLI den Befehl
gcloud compute regions listaus: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_IDdurch Ihre Projekt-ID.https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions
Informationen zu einer Region aufrufen
Console
Auf der Seite Zonen in derGoogle Cloud Console erhalten Sie Informationen zu Regionen.
gcloud
Um Informationen zu einer einzelnen Region abzurufen, führen Sie den Befehl
gcloud compute regions describeaus. Dabei istREGIONder 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-fREST
Stellen Sie eine
GET-Anfrage an die Methoderegions.get, um Informationen zu einer Region abzurufen. Ersetzen SiePROJECT_IDdurch Ihre Projekt-ID undREGIONdurch 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
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: 2026-01-24 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2026-01-24 (UTC)."],[],[]] -