Platzierungsrichtlinien ersetzen, entfernen oder löschen

In diesem Dokument wird beschrieben, wie Platzierungsrichtlinien ersetzt, entfernt oder gelöscht werden.

Das Ersetzen, Entfernen oder Löschen von Platzierungsrichtlinien ist in den folgenden Fällen nützlich:

  • Ersetzen einer Platzierungsrichtlinie in einer VM-Instanz, um die VM in eine andere Position relativ zu anderen VMs zu verschieben.

  • Entfernen Sie eine Platzierungsrichtlinie von einer VM, wenn Sie nicht mehr an ihrer Position im Verhältnis zu anderen VMs interessiert sind.

  • Löschen Sie eine Platzierungsrichtlinie, wenn Sie 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.

    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 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 zum Ersetzen, Entfernen oder Löschen von Platzierungsrichtlinien erforderlich:

  • So ersetzen oder entfernen Sie eine Platzierungsrichtlinie von einer VM: compute.instances.update on the project
  • So löschen Sie eine Platzierungsrichtlinie: compute.resourcePolicies.delete on the project

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

Platzierungsrichtlinie in einer VM ersetzen

Bevor Sie eine Richtlinie für verteilte Platzierung in einer VM durch eine kompakte Platzierung ersetzen, muss die VM einen unterstützten Maschinentyp und Hostwartungsrichtlinie verwenden. Wenn Sie die VM aktualisieren müssen, bevor Sie die Platzierungsrichtlinie ersetzen, führen Sie einen oder beide der folgenden Schritte aus:

Nachdem Sie die Platzierungsrichtlinie in einer VM ersetzt haben, müssen Sie die VM neu starten, damit die neu angewendete Platzierungsrichtlinie wirksam wird.

Wählen Sie eine der folgenden Optionen aus, um eine Platzierungsrichtlinie in einer VM zu ersetzen:

gcloud

  1. Verwenden Sie zum Exportieren der Attribute einer vorhandenen VM die Methode gcloud compute instances export-Befehl.

    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.

  2. Öffnen Sie die VM-Konfigurationsdatei in einem Texteditor Ihrer Wahl.

  3. 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/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 ist der Name der Platzierungsrichtlinie.

    Sie können auch andere Attribute der VM ändern. Weitere Informationen finden Sie unter Attribute, die aktualisiert werden können.

  4. Führen Sie die verbleibenden Schritte unter VM-Attribute aktualisieren aus.

REST

  1. Senden Sie eine GET-Anfrage an die Methode instances.get, um die Attribute einer vorhandenen VM zu exportieren.

    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.

    Die Anfrage gibt die Konfigurationsdetails der VM zurück.

  2. 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/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 ist der Name der Platzierungsrichtlinie.

    Sie können auch andere Attribute der VM ändern. Weitere Informationen finden Sie unter Attribute, die aktualisiert werden können.

  3. Führen Sie die verbleibenden Schritte unter VM-Attribute aktualisieren aus.

Platzierungsrichtlinie von einer VM entfernen

Wenn Sie eine Richtlinie für gestreute Platzierung mit zwei oder mehr Verfügbarkeitsdomains von einer VM entfernen möchten, können Sie die VM einfach beenden. Wenn Sie eine Richtlinie für kompakte Platzierung oder eine Richtlinie für gestreute Platzierung mit nur einer Verfügbarkeitsdomain entfernen möchten, müssen Sie zuerst die VM beenden, bevor Sie die mit ihr verbundene Platzierungsrichtlinie entfernen.

Das Entfernen einer Platzierungsrichtlinie von einer VM wirkt sich nicht auf ihren physischen Standort aus. Wenn für die VM jedoch eine Live-Migration ausgeführt wird, kann Compute Engine die VM an einen anderen physischen Standort verschieben.

Wählen Sie eine der folgenden Optionen aus, um eine Platzierungsrichtlinie von einer VM zu 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 prüfen Sie den Wert des Felds resourcePolicies, 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. Um den Namen der Platzierungsrichtlinie zu überprüfen, sehen Sie die Details der VM an und prüfen Sie den Wert im Feld resourcePolicies.

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. Wenn Sie eine Platzierungsrichtlinie löschen möchten, die auf eine oder mehrere Compute Engine-Ressourcen angewendet wird, führen Sie einen der folgenden Schritte aus:

Wählen Sie eine der folgenden Optionen aus, um eine Platzierungsrichtlinie zu 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