In diesem Dokument wird beschrieben, wie Sie Arbeitslastrichtlinien aufrufen.
Nachdem Sie Arbeitslastrichtlinien für verwaltete Instanzgruppen (MIGs) erstellt und angewendet haben, können Sie die Konfigurationsdetails dieser Richtlinien aufrufen. Wenn Sie sich Arbeitslastrichtlinien ansehen, erhalten Sie einen Überblick über alle Arbeitslastrichtlinien in Ihrem Projekt oder können die Konfigurationsdetails einer bestimmten Richtlinie prüfen.
Weitere Informationen zu den Anforderungen und Einschränkungen, die Sie beim Erstellen von Arbeitslastrichtlinien anwenden, finden Sie unter Arbeitslastrichtlinien.
Hinweis
-
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. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren:
Wählen Sie den Tab aus, der Ihrer geplanten Verwendung der Beispiele auf dieser Seite entspricht:
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 von Arbeitslastrichtlinien benötigen, bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) für Ihr Projekt zuzuweisen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von Arbeitslastrichtlinien erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um Arbeitslastrichtlinien aufzurufen:
-
So rufen Sie eine Liste Ihrer Arbeitslastrichtlinien auf:
compute.resourcePolicies.liston the project -
So rufen Sie die Details einer Arbeitslastrichtlinie auf:
compute.resourcePolicies.geton the project
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Arbeitslastrichtlinien ansehen
Verwenden Sie eine der folgenden Methoden, um die in Ihrem Projekt vorhandenen Workload-Richtlinien aufzurufen:
Weitere Informationen zur Konfiguration einer bestimmten Arbeitslastrichtlinie finden Sie unter Details zu einer Arbeitslastrichtlinie ansehen.
Liste der Arbeitslastrichtlinien aufrufen
Wählen Sie eine der folgenden Optionen aus, um eine Liste aller Workload-Richtlinien in Ihrem Projekt aufzurufen:
gcloud
Verwenden Sie zum Aufrufen einer Liste der Arbeitslastrichtlinien den Befehl gcloud compute resource-policies list, wobei das Flag --filter auf workloadPolicy:* gesetzt ist.
gcloud compute resource-policies list \
--filter="workloadPolicy:*"
Die Ausgabe sieht etwa so aus:
NAME: workload-policy-01
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2026-03-18T02:20:11.010-07:00
NAME: workload-policy-02
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2026-03-18T09:24:58.281-07:00
Weitere Informationen zur Verwendung von Filterausdrücken zum Eingrenzen einer Liste von Compute Engine-Ressourcen finden Sie unter Befehl gcloud topic filters.
REST
Wenn Sie eine Liste der Arbeitslastrichtlinien in einer bestimmten Region aufrufen möchten, senden Sie eine GET-Anfrage an die Methode resourcePolicies.list.
Fügen Sie in der Anfrage-URL den Abfrageparameter filter ein und legen Sie ihn auf workloadPolicy%3A* fest.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies?filter=workloadPolicy%3A*
Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, in dem Sie eine Liste der Workload-Richtlinien aufrufen möchten.REGION: die Region, in der eine oder mehrere Arbeitslastrichtlinien vorhanden sind.
Die Ausgabe sieht etwa so aus:
{
"kind": "compute#resourcePolicyList",
"id": "projects/example-project/regions/us-central1/resourcePolicies",
"items": [
{
"workloadPolicy": {
"type": "HIGH_THROUGHPUT"
},
"kind": "compute#resourcePolicy",
"id": "7592369487854686373",
"creationTimestamp": "2026-03-18T02:20:11.010-07:00",
"selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-01",
"region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
"name": "workload-policy-01",
"status": "READY"
},
{
"workloadPolicy": {
"type": "HIGH_THROUGHPUT",
"maxTopologyDistance": "BLOCK"
},
"kind": "compute#resourcePolicy",
"id": "5947350722329145141",
"creationTimestamp": "2026-03-18T09:24:58.281-07:00",
"selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-02",
"region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
"name": "workload-policy-02",
"status": "READY"
}
],
"selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies",
"etag": "ntWQ-oLKD9MWsxuxLOpT5pDF0To=/2MdxB9oc-_-zK6Z7g0OIqrUQ0BI="
}
Weitere Informationen zur Verwendung von Filterausdrücken zum Eingrenzen einer Liste von Ressourcenrichtlinien mithilfe der URL-Codierung finden Sie im Abschnitt zum Abfrageparameter filter.
Details einer Arbeitslastrichtlinie ansehen
Wählen Sie eine der folgenden Optionen aus, um die Details einer Arbeitslastrichtlinie aufzurufen:
gcloud
Wenn Sie die Details einer Arbeitslastrichtlinie aufrufen möchten, verwenden Sie den Befehl gcloud compute resource-policies describe.
gcloud compute resource-policies describe POLICY_NAME \
--region=REGION
Ersetzen Sie Folgendes:
POLICY_NAME: der Name einer vorhandenen Arbeitslastrichtlinie.REGION: die Region, in der die Arbeitslastrichtlinie vorhanden ist.
Die Ausgabe sieht etwa so aus:
creationTimestamp: '2026-03-18T02:20:11.010-07:00'
id: '7592369487854686373'
kind: compute#resourcePolicy
name: workload-policy-01
region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-01
status: READY
workloadPolicy:
type: HIGH_THROUGHPUT
REST
Stellen Sie eine GET-Anfrage an die Methode resourcePolicies.get, um die Details einer Arbeitslastrichtlinie aufzurufen.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME
Ersetzen Sie Folgendes:
PROJECT_ID: Die ID des Projekts, in dem sich die Arbeitslastrichtlinie befindet, für die Sie die Details aufrufen möchten.REGION: die Region, in der die Arbeitslastrichtlinie vorhanden ist.POLICY_NAME: der Name einer vorhandenen Arbeitslastrichtlinie.
Die Ausgabe sieht etwa so aus:
{
"workloadPolicy": {
"type": "HIGH_THROUGHPUT"
},
"kind": "compute#resourcePolicy",
"id": "7592369487854686373",
"creationTimestamp": "2026-03-18T02:20:11.010-07:00",
"selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-01",
"region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
"name": "workload-policy-01",
"status": "READY"
}