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 Cloud de Confiance by S3NS 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:
Wählen Sie den Tab für die gewünschte Verwendung der Beispiele auf dieser Seite aus:
Console
Wenn Sie über die Cloud de Confiance Console auf Dienste und APIs von Cloud de Confiance by S3NS zugreifen, müssen Sie die Authentifizierung nicht einrichten.
gcloud
-
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an. Nach der Anmeldung initialisieren Sie die Google Cloud CLI mit dem folgenden Befehl:
gcloud init
-
- Legen Sie eine Standardregion und -zone fest.
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 und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an.
Weitere Informationen finden Sie in der Dokumentation zur Cloud de Confiance -Authentifizierung unter Für die Verwendung von REST authentifizieren.
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
Eine Zone ist ein Bereitstellungsbereich innerhalb einer Region. Einige Regionen haben spezielle Zonen, die erhebliche Kapazitäten für stark nachgefragte Beschleuniger (GPUs und TPUs) bieten. Diese speziellen Zonen werden als KI-Zonen bezeichnet und eignen sich ideal für KI- und ML-Arbeitslasten.
Verwenden Sie eine der folgenden Optionen, um eine Liste der verfügbaren Zonen, einschließlich der KI-Zonen, aufzurufen:
Console
Rufen Sie eine Liste der Zonen auf der Seite Zonen in der Cloud de Confiance 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 Zonen ansehen, die Beschleuniger (GPUs und TPUs) unterstützen
Verwenden Sie eine der folgenden Methoden, um eine Liste der Zonen aufzurufen, die Beschleuniger (GPUs und TPUs) unterstützen:
- Wenn Sie KI-Zonen mit hoher Kapazität für Beschleuniger suchen, suchen Sie nach KI-Zonen.
- Wenn Sie alle Zonen finden möchten, die einen bestimmten Beschleuniger unterstützen, suchen Sie nach dem 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 ai im Namen. us-central1-ai1a ist beispielsweise eine KI-Zone in der Region us-central1, wobei us-central1-a die übergeordnete Zone ist. Weitere Informationen finden Sie unter KI-Zonen.
In der Cloud de Confiance Console werden KI-Zonen zusammen mit anderen Zonen nach Regionen gruppiert aufgeführt. Wenn Sie eine Liste der verfügbaren KI-Zonen aufrufen möchten, verwenden Sie die gcloud CLI oder die REST API.
Console
In der Cloud de Confiance Console werden auf der Seite Zonen die KI-Zonen in einer Region aufgeführt, in der diese Zonen unterstützt werden. Sie erkennen eine KI-Zone am String AI im Namen. In der Region us-central1 wird beispielsweise Zone AI1A aufgeführt.
gcloud
Verwenden Sie den Befehl gcloud compute zones list und filtern Sie nach Zonen, die den String ai enthalten:
gcloud compute zones list \
--filter="name~'-ai'"
REST
Stellen Sie eine GET-Anfrage an die Methode zones.list. Wenn Sie Zonen abgleichen möchten, die ai im Namen enthalten, verwenden Sie den Abfrageparameter filter mit dem regulären Ausdruck name eq '.*-ai.*'.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones?filter=name%20eq%20'.*-ai.*'
Ersetzen Sie PROJECT_ID durch Ihre PROJECT_ID.
Nach Beschleunigertyp suchen
Wenn Sie nach einem Beschleunigertyp suchen, werden alle Zonen, einschließlich KI-Zonen, zurückgegeben, in denen dieser Beschleuniger unterstützt wird.
gcloud
Wenn Sie nach Beschleunigertyp suchen möchten, verwenden Sie den Befehl gcloud compute accelerator-types list mit dem Flag --filter.
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 mit dem Parameter filter an die Methode acceleratorTypes.aggregatedList.
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
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 list mit dem Flag --filter.
Wenn Sie beispielsweise alle Zonen mit einem bestimmten Maschinentyp wie dem A4-Maschinentyp a4-highgpu-8g oder dem Cloud TPU v6e (Trillium)-Maschinentyp ct6e-standard-4t suchen 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 (Trillium)-Maschinentypgcloud 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 Methode machineTypes.aggregatedList mit dem Parameter filter.
Wenn Sie beispielsweise alle Zonen mit einem bestimmten Maschinentyp wie dem A4-Maschinentyp a4-highgpu-8g oder dem Cloud TPU v6e (Trillium)-Maschinentyp ct6e-standard-4t suchen 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 (Trillium)-MaschinentypGET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=ct6e-standard-4t
Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID und den Maschinentyp durch den Maschinentyp, nach dem Sie suchen möchten.
KI-Zonen aus Listen ausschließen
Wenn Sie Zugriff auf KI-Zonen haben, diese aber nicht in Ihren Zonenlisten sehen möchten, können Sie sie mithilfe von Filtern ausschließen. Das kann der Fall sein, wenn Sie Dienste verwenden, die von KI-Zonen nicht unterstützt werden, oder wenn Sie eine vorhandene Automatisierung haben, die von der Liste der Zonen abhängt. Sie erkennen KI-Zonen am Suffix -ai in ihren Namen.
gcloud
Wenn Sie KI-Zonen aus der Liste der verfügbaren Zonen ausschließen möchten, verwenden Sie den Befehl gcloud compute zones list und filtern Sie Zonen, die den String -ai enthalten:
gcloud compute zones list --filter 'name !~ ".*-ai.*"'
Wenn Sie KI-Zonen beim Auflisten von Maschinentypen herausfiltern möchten, verwenden Sie den Befehl gcloud compute machine-types list und filtern Sie Zonen, die den String -ai enthalten:
gcloud compute machine-types list --filter 'zone !~ ".*-ai.*"'
REST
Wenn Sie KI-Zonen aus API-Ergebnissen ausschließen möchten, verwenden Sie den regulären Ausdruck name ne ".*-ai.*" im Filterabfrageparameter. Wenn Sie diesen Filter einer URL hinzufügen, müssen Sie den Filter-Suchparameter als filter=name%20ne%20%22.%2A-ai.%2A%22 codieren.
https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones?filter=name%20ne%20%22.%2A-ai.%2A%22
Ersetzen Sie PROJECT_ID durch Ihre PROJECT_ID.
Terraform
Wenn Sie KI-Zonen aus der Liste der verfügbaren Zonen ausschließen möchten, erstellen Sie eine lokale Funktion wie im folgenden Beispiel:
# Fetch zones from API
data "google_compute_zones" "available" {
project = var.my_project_id
region = var.my_region
status = "UP"
}
locals {
# Filter the list in Terraform
non_ai_zones = [
for zone in data.google_compute_zones.available.names : zone
if !strcontains(zone, "-ai")
]
}
# Example usage
output "standard_gce_zones" {
description = "List of zones, excluding AI/ML zones."
value = locals.non_ai_zones
}
Liste der verfügbaren Regionen ansehen
Console
Die verfügbaren Regionen finden Sie in derCloud de Confiance Console auf der Seite Zonen.
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 derCloud de Confiance 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