Platzierungsrichtlinien ansehen

In diesem Dokument wird beschrieben, wie Sie Platzierungsrichtlinien aufrufen.

Das Aufrufen von Platzierungsrichtlinien ist nützlich, um alle vorhandenen Platzierungsrichtlinien in einem Projekt zu sehen oder die Konfigurationsdetails einer bestimmten Platzierungsrichtlinie zu prüfen.

Hinweise

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die Berechtigungen zu gewähren, die Sie zum Aufrufen von Platzierungsrichtlinien benötigen. Compute-Instanzadministrator (Version 1) (roles/compute.instanceAdmin.v1) IAM-Rolle für Ihr Projekt. 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 Platzierungsrichtlinien erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind für das Aufrufen von Platzierungsrichtlinien erforderlich:

  • Um die Liste der Platzierungsrichtlinien aufzurufen: compute.resourcePolicies.list on the project
  • Um die Details einer Platzierungsrichtlinie anzusehen: compute.resourcePolicies.get on the project

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Platzierungsrichtlinien ansehen

Wählen Sie eine der folgenden Methoden, die in diesem Dokument beschrieben werden, um die in einem Projekt verfügbaren Platzierungsrichtlinien aufzurufen:

Liste der Platzierungsrichtlinien aufrufen

Wählen Sie eine der folgenden Optionen aus, um eine Liste aller Platzierungsrichtlinien in Ihrem Projekt aufzurufen:

gcloud

Verwenden Sie zum Aufrufen einer Liste der Platzierungsrichtlinien den Befehl gcloud compute resource-policies list, wobei das Flag --filter auf groupPlacementPolicy:* gesetzt ist.

gcloud compute resource-policies list \
    --filter="groupPlacementPolicy:*"

Die Ausgabe sieht in etwa so aus:

NAME: example-compact-policy
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2024-05-09T02:09:24.588-07:00

NAME: example-spread-policy
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2024-05-09T02:08:13.404-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

So rufen Sie eine Liste der Platzierungsrichtlinien auf, die sich in einer bestimmten Region befinden: Erstellen 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 groupPlacementPolicy%3A* fest.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies?filter=groupPlacementPolicy%3A*

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID des Projekts, in dem Sie eine Liste der Platzierungsrichtlinien aufrufen möchten.

  • REGION: die Region, in der sich eine oder mehrere Platzierungsrichtlinien befinden.

Die Ausgabe sieht in etwa so aus:

{
  "kind": "compute#resourcePolicyList",
  "id": "projects/example-project/regions/us-central1/resourcePolicies",
  "items": [
    {
      "kind": "compute#resourcePolicy",
      "id": "5587673659722509355",
      "creationTimestamp": "2024-05-09T02:09:24.588-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "example-compact-policy",
      "groupPlacementPolicy": {
        "collocation": "COLLOCATED"
      },
      "status": "READY"
    },
    {
      "kind": "compute#resourcePolicy",
      "id": "5970772604948130963",
      "creationTimestamp": "2024-05-09T02:08:13.404-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "example-spread-policy",
      "groupPlacementPolicy": {
        "availabilityDomainCount": 5
      },
      "status": "READY"
    }
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies",
  "etag": "-L7XCupTQ5V9__TOJ8G5RDcR2cY=/g_xt0udkOM_tU7jSL0z9I2Sivis="
}

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 Platzierungsrichtlinie ansehen

Wählen Sie eine der folgenden Optionen aus, um die Details einer Platzierungsrichtlinie aufzurufen:

gcloud

Verwenden Sie den Befehl gcloud compute resource-policies describe, um die Details zu einer Platzierungsrichtlinie aufzurufen:

gcloud compute resource-policies describe POLICY_NAME \
    --region=REGION

Ersetzen Sie Folgendes:

  • POLICY_NAME: der Name einer vorhandenen Platzierungsrichtlinie.

  • REGION: die Region, in der sich die Platzierungsrichtlinie befindet.

Die Ausgabe sieht in etwa so aus:

  • So rufen Sie die Details einer Richtlinie für kompakte Platzierung auf:

    creationTimestamp: '2024-05-09T02:09:24.588-07:00'
groupPlacementPolicy:
  collocation: COLLOCATED
id: '5587673659722509355'
kind: compute#resourcePolicy
name: example-compact-policy
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/example-compact-policy
status: READY

  • So rufen Sie die Details einer Richtlinie für gestreute Platzierung auf:

    creationTimestamp: '2024-05-09T02:08:13.404-07:00'
groupPlacementPolicy:
  availabilityDomainCount: 5
id: '5970772604948130963'
kind: compute#resourcePolicy
name: example-spread-policy
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/example-spread-policy
status: READY

REST

Stellen Sie eine GET-Anfrage an die Methode resourcePolicies.get, um die Details einer Platzierungsrichtlinie 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 Platzierungsrichtlinie befindet, für die Sie die Details aufrufen möchten.

  • REGION: die Region, in der sich die Platzierungsrichtlinie befindet.

  • POLICY_NAME: der Name einer vorhandenen Platzierungsrichtlinie.

Die Ausgabe sieht in etwa so aus:

  • So rufen Sie die Details einer Richtlinie für kompakte Platzierung auf:

    {
  "kind": "compute#resourcePolicy",
  "id": "5587673659722509355",
  "creationTimestamp": "2024-05-09T02:09:24.588-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "example-compact-policy",
  "groupPlacementPolicy": {
    "collocation": "COLLOCATED"
  },
  "status": "READY"
}

  • So rufen Sie die Details einer Richtlinie für gestreute Platzierung auf:

    {
  "kind": "compute#resourcePolicy",
  "id": "5970772604948130963",
  "creationTimestamp": "2024-05-09T02:08:13.404-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "example-spread-policy",
  "groupPlacementPolicy": {
    "availabilityDomainCount": 5
  },
  "status": "READY"
}

Nächste Schritte