Platzierungsrichtlinien ansehen

In diesem Dokument wird beschrieben, wie Sie Platzierungsrichtlinien aufrufen. Insbesondere wird erläutert, wie Sie die verfügbaren Platzierungsrichtlinien in einem bestimmten Projekt oder die Konfigurationsdetails einer dieser Richtlinien aufrufen.

Hinweise

  • Überprüfen Sie die Einschränkungen für Platzierungsrichtlinien.
  • 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 für das Projekt die IAM-Rolle Compute-Instanzadministrator (v1) (roles/compute.instanceAdmin.v1) zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen oder Löschen von Platzierungsrichtlinien benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen oder Löschen 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 oder Löschen von Platzierungsrichtlinien erforderlich:

  • So rufen Sie eine Liste Ihrer Platzierungsrichtlinien auf: compute.resourcePolicies.list für das Projekt
  • So rufen Sie die Details einer Platzierungsrichtlinie auf: compute.resourcePolicies.get für das Projekt

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

Platzierungsrichtlinien ansehen

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

Liste der Platzierungsrichtlinien aufrufen

Mit der gcloud CLI und REST können Sie eine Liste aller Platzierungsrichtlinien in einem bestimmten Projekt aufrufen.

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: policy-1
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2023-07-15T02:10:51.958-08:00

NAME: policy-2
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2023-07-15T02:11:16.826-08: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": "637231102400797797",
      "creationTimestamp": "2023-07-28T04:12:11.072-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/policy-1",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "policy-1",
      "groupPlacementPolicy": {
        "collocation": "COLLOCATED"
      },
      "status": "READY"
    },
    {
      "kind": "compute#resourcePolicy",
      "id": "1228789480840827204",
      "creationTimestamp": "2023-07-15T02:10:51.958-08:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/policy-2",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "policy-2",
      "groupPlacementPolicy": {
        "availabilityDomainCount": 2
      },
      "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

Sie können die Details einer Platzierungsrichtlinie in einem bestimmten Projekt mit der gcloud CLI und REST aufrufen.

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:

creationTimestamp: '2023-07-15T02:10:51.958-08:00'
groupPlacementPolicy:
  availabilityDomainCount: 2
id: '1228789480840827204'
kind: compute#resourcePolicy
name: pp2
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-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:

{
  "kind": "compute#resourcePolicy",
  "id": "637231102400797797",
  "creationTimestamp": "2023-07-28T04:12:11.072-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-policy",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "policy-1",
  "groupPlacementPolicy": {
      "availabilityDomainCount": 2
  },
  "status": "READY"
}

Nächste Schritte