Diese Seite wurde von der Cloud Translation API übersetzt.

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. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

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:

Rufen Sie eine Liste der Platzierungsrichtlinien auf, um alle vorhandenen Platzierungsrichtlinien in einem Projekt zu sehen.
Weitere Informationen zur Konfiguration einer Platzierungsrichtlinie finden Sie in den Details zu einer Platzierungsrichtlinie.

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

Informationen zum Ersetzen, Entfernen oder Löschen von Platzierungsrichtlinien
So wenden Sie eine Platzierungsrichtlinie an:
- Richtlinien für kompakte Platzierungsrichtlinien auf VMs anwenden
- Richtlinien für gestreute Platzierungsrichtlinien auf VMs anwenden
So funktionierts Prüfen Sie den Standort von VMs, die Richtlinien für kompakte Platzierung verwenden.