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 Trusted Cloud by S3NS -Dienste und APIs überprüft.
Zum Ausführen von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei der Compute Engine authentifizieren:
Select the tab for how you plan to use the samples on this page:
gcloud
-
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an. Nach der Anmeldung initialisieren Sie die Google Cloud CLI mit folgendem Befehl:
gcloud init
- Set a default region and zone.
REST
Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an. Nach der Anmeldung initialisieren Sie die Google Cloud CLI mit folgendem Befehl:
gcloud init
Weitere Informationen finden Sie in der Dokumentation zur Trusted Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.
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:
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
aufgroupPlacementPolicy:*
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 MethoderesourcePolicies.list
. Fügen Sie in der Anfrage-URL den Abfrageparameterfilter
ein und legen Sie ihn aufgroupPlacementPolicy%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 MethoderesourcePolicies.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
Informationen zum Ersetzen, Entfernen oder Löschen von Platzierungsrichtlinien
So wenden Sie eine Platzierungsrichtlinie an:
So funktionierts Prüfen Sie den Standort von VMs, die Richtlinien für kompakte Platzierung verwenden.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-18 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-18 (UTC)."],[[["This document guides you through the process of viewing existing placement policies within a project, including how to check specific configurations."],["To list all placement policies, use the `gcloud compute resource-policies list` command with the `--filter` flag or make a `GET` request to the `resourcePolicies.list` method in REST API, filtering with `groupPlacementPolicy:*`."],["To view detailed information about a specific placement policy, utilize the `gcloud compute resource-policies describe` command or make a `GET` request to the `resourcePolicies.get` method in REST API, specifying the policy name and region."],["Ensure you have the necessary permissions, specifically the Compute Instance Admin (v1) role, or the `compute.resourcePolicies.list` and `compute.resourcePolicies.get` permissions, to view placement policies."],["Instructions are given to authenticate using the gcloud CLI and the REST API, and there are further resources to learn about the replacing, removing, deleting, and applying of placement policies."]]],[]] -