Arbeitslastrichtlinien ansehen

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

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.list on the project
  • So rufen Sie die Details einer Arbeitslastrichtlinie auf: compute.resourcePolicies.get on 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:

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"
}

Nächste Schritte