Platzierungsrichtlinien ersetzen, entfernen oder löschen

In diesem Dokument wird erläutert, wie Sie Platzierungsrichtlinien verwalten. Zum Beispiel:

Aktualisieren Sie die Attribute einer VM-Instanz, die eine Platzierungsrichtlinie angibt, um einen der folgenden Schritte auszuführen:
- Die Platzierungsrichtlinie durch eine andere vorhandene Platzierungsrichtlinie ersetzen.
- Die Platzierungsrichtlinie entfernen.
Eine Platzierungsrichtlinie löschen, die Sie nicht mehr benötigen.

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.

Wählen Sie den Tab für die Verwendung der Beispiele auf dieser Seite aus:
gcloud
1. Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:
```
gcloud init
```
  Hinweis: Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die neueste Version haben, indem Sie gcloud components update ausführen.
2. Legen Sie eine Standardregion und -zone fest.
REST

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

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen für das Projekt die IAM-Rolle Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ersetzen, Entfernen 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 Ersetzen, Entfernen oder Löschen von Platzierungsrichtlinien erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Platzierungsrichtlinien zu ersetzen, zu entfernen oder zu löschen:

So aktualisieren Sie die Attribute einer VM: compute.instances.update für das Projekt
So löschen Sie eine Platzierungsrichtlinie: compute.resourcePolicies.delete für das Projekt

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

Platzierungsrichtlinie in einer VM ersetzen

Sie können die in einer VM angegebene Platzierungsrichtlinie mithilfe der gcloud CLI und REST durch eine andere Platzierungsrichtlinie ersetzen.

gcloud

So ersetzen Sie eine Platzierungsrichtlinie in einer VM durch eine andere Platzierungsrichtlinie:

Verwenden Sie zum Exportieren der Attribute einer vorhandenen VM den Befehl gcloud compute instances export.
```
gcloud compute instances export VM_NAME \
    --destination=FILE_PATH \
    --zone=ZONE
```
Ersetzen Sie Folgendes:
- VM_NAME: Der Name einer vorhandenen VM, die eine Platzierungsrichtlinie angibt.
- FILE_PATH: Der Pfad, unter dem Sie die VM-Konfigurationsdatei speichern möchten.
- ZONE ist die Zone, in der sich die VM befindet.
Öffnen Sie die VM-Konfigurationsdatei in einem Texteditor Ihrer Wahl.
Wenn Sie die Platzierungsrichtlinie durch eine andere vorhandene Richtlinie ersetzen möchten, ersetzen Sie den Wert im Feld resourcePolicies durch eine andere Platzierungsrichtlinie.
```
...
resourcePolicies:
- https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/another-example-policy
...
```
Sie können auch andere Attribute der VM ändern. Weitere Informationen finden Sie unter Attribute, die aktualisiert werden können.
Führen Sie die verbleibenden Schritte unter VM-Attribute aktualisieren aus.

REST

So ersetzen Sie eine Platzierungsrichtlinie in einer VM durch eine andere Platzierungsrichtlinie:

Senden Sie zum Exportieren der Attribute einer vorhandenen VM eine GET-Anfrage an die Methode instances.get.
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
```
Ersetzen Sie Folgendes:
- PROJECT_ID: die Projekt-ID des Projekts, in dem sich die VM befindet.
- ZONE ist die Zone, in der sich die VM befindet.
- VM_NAME: Der Name einer vorhandenen VM, die eine Platzierungsrichtlinie angibt.
Wenn Sie die Platzierungsrichtlinie durch eine andere vorhandene Richtlinie ersetzen möchten, ersetzen Sie den Wert im Feld resourcePolicies durch eine andere Platzierungsrichtlinie.
```
{
...
"resourcePolicies": [
  "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/another-example-policy"
],
...
}
```
Sie können auch andere Attribute der VM ändern. Weitere Informationen finden Sie unter Attribute, die aktualisiert werden können.
Führen Sie die verbleibenden Schritte unter VM-Attribute aktualisieren aus.

Platzierungsrichtlinie aus einer VM entfernen

Sie können die auf eine VM angewendete Platzierungsrichtlinie mit der gcloud CLI und REST entfernen.

gcloud

Verwenden Sie zum Entfernen einer Platzierungsrichtlinie von einer VM den Befehl gcloud compute instances remove-resource-policies.

gcloud compute instances remove-resource-policies VM_NAME \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

Ersetzen Sie Folgendes:

VM_NAME: Der Name einer vorhandenen VM, die eine Platzierungsrichtlinie angibt.
POLICY_NAME: Der Name der Platzierungsrichtlinie, die auf die VM angewendet wird. Prüfen Sie die Details der VM und sehen Sie sich das Feld resourcePolicies an, um den Namen der Platzierungsrichtlinie zu bestätigen.
ZONE ist die Zone, in der sich die VM befindet.

REST

Senden Sie zum Entfernen einer Platzierungsrichtlinie von einer VM eine POST-Anfrage an die Methode instances.removeResourcePolicies.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/removeResourcePolicies

{
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}

Ersetzen Sie Folgendes:

PROJECT_ID: die Projekt-ID des Projekts, in dem sich die VM befindet.
ZONE: die Zone, in der sich die VM befindet.
VM_NAME: Der Name einer vorhandenen VM, die eine Platzierungsrichtlinie angibt.
REGION: die Region, in der sich die Platzierungsrichtlinie befindet.
POLICY_NAME: Der Name der Platzierungsrichtlinie, die auf die VM angewendet wird. Prüfen Sie die Details der VM und sehen Sie sich das Feld resourcePolicies an, um den Namen der Platzierungsrichtlinie zu bestätigen.

Platzierungsrichtlinie löschen

Sie können eine Platzierungsrichtlinie nur löschen, wenn sie auf keine Compute Engine-Ressourcen angewendet wird. Andernfalls schlägt das Löschen der Platzierungsrichtlinie fehl. Führen Sie einen der folgenden Schritte aus, um eine Platzierungsrichtlinie zu löschen, die auf eine Compute Engine-Ressource angewendet wird:

Wenn die Richtlinie nur auf VMs angewendet wird und Sie die VMs beibehalten möchten, gehen Sie so vor:
1. Entfernen Sie die Platzierungsrichtlinie von den VMs.
2. Löschen Sie die Platzierungsrichtlinie.
Gehen Sie andernfalls so vor:
1. Optional: Entfernen Sie die Platzierungsrichtlinie von allen VMs, die Sie beibehalten möchten.
2. Löschen Sie alle anderen Compute Engine-Ressourcen, auf die die Platzierungsrichtlinie angewendet wird, in der folgenden Reihenfolge:
  1. VM
  2. Reservierungen
  3. Instanzvorlagen
3. Löschen Sie die Platzierungsrichtlinie.

Sie können eine Platzierungsrichtlinie mit der gcloud CLI und REST löschen.

gcloud

Verwenden Sie zum Löschen einer Platzierungsrichtlinie den Befehl gcloud compute resource-policies delete.

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

Ersetzen Sie Folgendes:

POLICY_NAME: der Name einer vorhandenen Platzierungsrichtlinie.
REGION: die Region, in der sich die Platzierungsrichtlinie befindet.

REST

Senden Sie zum Löschen einer Platzierungsrichtlinie eine DELETE-Anfrage an die Methode resourcePolicies.delete.

DELETE 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.
REGION: die Region, in der sich die Platzierungsrichtlinie befindet.
POLICY_NAME: der Name einer vorhandenen Platzierungsrichtlinie.

Nächste Schritte

Platzierungsrichtlinien anzeigen.
Weitere Informationen dazu, wie Sie mit einer VM, die eine Platzierungsrichtlinie angibt:
- Den Status der VM aufrufen.
- Verbindung zur VM herstellen