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

  • 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. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren.

    Select the tab for how you plan to use the samples on this page:

    gcloud

    1. Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

        Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl: 

        gcloud init

      Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die Berechtigung zu gewähren, um die Berechtigungen zu erhalten, 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 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

Senden Sie eine GET-Anfrage an die Methode resourcePolicies.list, um eine Liste der Platzierungsrichtlinien aufzurufen, die sich in einer bestimmten Region befinden. Fügen Sie in der Anfrage-URL den Abfrageparameter filter ein und legen Sie dafür 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

  • Wenn Sie die Details einer Richtlinie für gestreute Platzierungen anzeigen:

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

  • Wenn Sie die Details einer Richtlinie für gestreute Platzierungen anzeigen:

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