VM-Erweiterungen mit Erweiterungsrichtlinien verwalten

VM Extension Manager verwendet Erweiterungsrichtlinien, um Ihre VM-Erweiterungen in großem Umfang zu verwalten. Weitere Informationen finden Sie unter Informationen zu VM Extension Manager. In diesem Dokument wird beschrieben, wie Sie globale und zonale VM-Erweiterungsrichtlinien auf Projektebene oder auf Ordner- und Organisationsebene (in der Vorabversion verfügbar) aktualisieren und löschen. Informationen zum Aufrufen von Erweiterungsrichtlinien, VM-Erweiterungen und -Versionen sowie Laufzeiterweiterungsstatus auf VM-Instanzen finden Sie unter Details und Status von VM-Erweiterungen ansehen. Informationen zur Diagnose von Installations- oder Laufzeitproblemen finden Sie unter Fehlerbehebung bei VM-Erweiterungen.

Einschränkungen bei der Richtlinienverwaltung

Sie können VM-Erweiterungsrichtlinien auf Ordner- und Organisationsebene nur mit der Google Cloud CLI oder der Compute Engine REST API aktualisieren und löschen. Sie können Richtlinien auf Ordner- oder Organisationsebene nicht in derGoogle Cloud Console verwalten.

Erweiterungen durch Aktualisieren einer VM-Erweiterungsrichtlinie ändern

Wenn Sie eine Richtlinie aktualisieren, werden die Änderungen von VM Extension Manager in der Regel innerhalb einer Minute auf alle entsprechenden VMs übertragen. Wenn Sie Einschlusslabels ändern, werden Erweiterungen möglicherweise auf neuen VMs installiert oder von vorhandenen VMs deinstalliert, je nachdem, ob sie mit den aktualisierten Labels übereinstimmen.

VM-Erweiterungen in allen Zonen einer Organisation ändern

Vorschau

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) für Ihre Organisation zu gewähren, um die Berechtigung zu erhalten, die Sie zum Aktualisieren einer organisationsweiten Erweiterungsrichtlinie benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.orgVmExtensionPolicies.update, die zum Aktualisieren einer organisationsweiten Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine globale Erweiterungsrichtlinie auf Organisationsebene zu aktualisieren:

gcloud

Verwenden Sie den Befehl gcloud preview compute global-vm-extension-policies update mit dem Flag --organization, um eine vorhandene globale VM-Erweiterungsrichtlinie auf Organisationsebene zu ändern. Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Richtlinie vollständig ersetzt. Alle optionalen Felder, die Sie weglassen, werden auf ihre Standardwerte zurückgesetzt, anstatt die vorhandenen Werte aus der geänderten Richtlinie beizubehalten.

Führen Sie den folgenden Befehl aus, um eine globale VM-Erweiterungsrichtlinie auf Organisationsebene zu aktualisieren:

gcloud preview compute global-vm-extension-policies update POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der zu aktualisierenden VM-Erweiterungsrichtlinie.
• ORGANIZATION_ID: Ihre Google Cloud Organisations-ID.
• DESCRIPTION: eine optionale Beschreibung der Richtlinie.
• EXTENSION_NAME_1,EXTENSION_NAME_2: Eine durch Kommas getrennte Liste von Erweiterungen, die der Richtlinie hinzugefügt werden sollen. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert die Version der Erweiterung ist. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  Hinweis: Für ops-agent unterstützt VM Extension Manager die Installation von Version 2.58.0 oder neueren Versionen. Für google-cloud-sap-extension und google-cloud-workload-extension unterstützt VM Extension Manager nur die aktuelle Version.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert der Pfad zur Konfigurationsdatei für diese Erweiterung ist. Diese Datei befindet sich auf der VM, auf der Sie den Befehl gcloud ausführen, nicht auf der VM, auf der Sie die Erweiterung installieren.

  Wenn Sie die Konfiguration als Inline-String angeben möchten, verwenden Sie stattdessen das Flag --config anstelle von --config-from-file, z. B. EXTENSION_NAME_1="CONFIG_1". Sie können entweder --config-from-file oder --config verwenden, aber nicht beide im selben Befehl.

• KEY_1=VALUE_1: eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Einschlusslabels für einen Selektor definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die einem der angegebenen Selektoren entsprechen (logisches ODER). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für alle VMs in allen untergeordneten Projekten und Zonen der Organisation.
• PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.
• ROLLOUT_PLAN: Geben Sie slow_rollout oder fast_rollout an. Wenn Sie einen benutzerdefinierten Roll-out-Plan verwenden möchten, geben Sie das Flag --rollout-custom-plan anstelle von --rollout-predefined-plan im folgenden Format an:

  --rollout-custom-plan=organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Ersetzen Sie Folgendes:

  • ORGANIZATION_ID: die Organisation, in der der Roll-out-Plan definiert ist.
  • ROLLOUT_PLAN_NAME: der Name des von Ihnen definierten benutzerdefinierten Roll-out-Plans.

  Wenn Sie kein Flag für den Roll-out-Plan angeben, verwendet der VM Extension Manager slow_rollout.

• ROLLOUT_CONFLICT_BEHAVIOR: Gibt das Verhalten an, wenn VM Extension Manager einen Konflikt zwischen einer zonalen und einer globalen Richtlinie erkennt. Sie können eines der folgenden Konfliktverhalten angeben:
  • "" (leerer String): Die globale Richtlinie überschreibt keine in Konflikt stehenden zonalen Richtlinien mit demselben Namen. Dieses Konfliktverhalten ist die Standardeinstellung.
  • overwrite: Die globale Richtlinie überschreibt alle zonalen Richtlinien mit demselben Namen. Anschließend werden die Richtlinien-Roll-outs in der Zone über die globale Richtlinie verwaltet.

  Weitere Informationen finden Sie unter dem Flag --rollout-conflict-behavior.

• RETRY_UUID: eine UUID, die einen Wiederholungsversuch für die Einführung eines Richtlinienupdates identifiziert. Mit dieser UUID können Sie eine Aktualisierung ohne Änderungen wiederholen. Wenn Sie dieses Flag festlegen und die Richtlinie geändert wird, tritt ein Fehler auf. Weitere Informationen finden Sie unter Roll-out wiederholen.

Beispiel: Globale Richtlinie auf Organisationsebene aktualisieren

Mit dem folgenden Befehl wird die Richtlinie prod-frontend-policy in der Organisation 123456789 aktualisiert, um die Erweiterung google-cloud-workload-extension hinzuzufügen und die Fixierung von ops-agent aufzuheben, sodass die aktuelle Version mit einem schnellen Roll-out-Plan verfolgt wird:

gcloud preview compute global-vm-extension-policies update prod-frontend-policy \
  --organization=organizations/123456789 \
  --description="Updated policy: ops-agent + workload extension, unpinned" \
  --extensions=ops-agent,google-cloud-workload-extension \
  --config=ops-agent="updated-monitoring-config" \
  --inclusion-labels="env=prod,workload=frontend" \
  --priority=100 \
  --rollout-predefined-plan=fast_rollout

REST

Wenn Sie eine globale Erweiterungsrichtlinie auf Organisationsebene aktualisieren möchten, senden Sie eine PATCH-Anfrage an die Methode organizationGlobalVmExtensionPolicies.update. Wenn Sie eine Richtlinie mit REST aktualisieren, müssen Sie nur die Felder angeben, die Sie aktualisieren möchten. Alle Felder, die Sie weglassen, behalten ihre vorhandenen Werte bei.

PATCH https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

Ersetzen Sie Folgendes:

• ORGANIZATION_ID: Ihre Google Cloud Organisations-ID.
• POLICY_NAME: der Name der zu aktualisierenden VM-Erweiterungsrichtlinie.
• DESCRIPTION: Eine Beschreibung der VM-Erweiterungsrichtlinie.
• EXTENSION_NAME: der Name der zu aktualisierenden Erweiterung, der als Schlüssel in der extensionPolicies-Zuordnung verwendet wird. Wenn Sie mehrere Erweiterungen aktualisieren möchten, fügen Sie mehrere Einträge in die extensionPolicies-Zuordnung ein.
• EXTENSION_NAME_VERSION: die Version der VM-Erweiterung.
• EXTENSION_NAME_CONFIG: Konfigurationseinstellungen für die VM-Erweiterung als Inline-String.
• KEY_1:VALUE_1, KEY_2:VALUE_2: Schlüssel/Wert-Paare, die Einschlusslabels für eine Auswahl definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie mehrere Selektoren angeben möchten, fügen Sie dem instanceSelectors-Array mehrere Objekte hinzu, jeweils mit einem labelSelector-Feld. In diesem Fall zielt der VM Extension Manager auf VMs ab, die mit einem der angegebenen Selektoren übereinstimmen (logisches ODER). Wenn Sie instanceSelectors weglassen, gilt die Richtlinie für alle VMs in allen untergeordneten Projekten und Zonen der Organisation.
• PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.
• ROLLOUT_CONFLICT_BEHAVIOR: Gibt das Verhalten an, wenn VM Extension Manager einen Konflikt zwischen einer zonalen und einer globalen Richtlinie erkennt. Sie können eines der folgenden Konfliktverhalten angeben:
  • "" (leerer String): Die globale Richtlinie überschreibt keine in Konflikt stehenden zonalen Richtlinien mit demselben Namen. Dieses Konfliktverhalten ist die Standardeinstellung.
  • overwrite: Die globale Richtlinie überschreibt alle zonalen Richtlinien mit demselben Namen. Anschließend werden die Richtlinien-Roll-outs in der Zone über die globale Richtlinie verwaltet.

  Weitere Informationen finden Sie unter dem Flag --rollout-conflict-behavior.

• ROLLOUT_PLAN_NAME: der Name des von Ihnen definierten benutzerdefinierten Roll-out-Plans. Wenn Sie einen vordefinierten Roll-out-Plan verwenden möchten, ersetzen Sie das Feld name durch predefinedRolloutPlan und geben Sie einen der folgenden Werte an:
  • SLOW_ROLLOUT: Die Richtlinie wird über fünf Tage hinweg eingeführt. Dieser vordefinierte Plan ist der Standard-Roll-out-Plan, wenn Sie keinen Plan angeben.
  • FAST_ROLLOUT: Die Richtlinie wird sofort in allen Zonen eingeführt.
• RETRY_UUID: eine UUID, die einen Wiederholungsversuch für die Einführung eines Richtlinienupdates identifiziert.

VM-Erweiterungen in allen Zonen in einem Ordner ändern

Vorschau

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Folder level Compute VM extension policies admin (roles/compute.folderVmExtensionPolicyAdmin) für Ihren Ordner zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Aktualisieren einer ordnerbezogenen Erweiterungsrichtlinie benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.folderVmExtensionPolicies.update, die zum Aktualisieren einer ordnerbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine globale Erweiterungsrichtlinie auf Ordnerebene zu aktualisieren:

gcloud

Verwenden Sie den Befehl gcloud preview compute global-vm-extension-policies update mit dem Flag --folder, um eine vorhandene globale VM-Erweiterungsrichtlinie auf Ordnerebene zu ändern. Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Richtlinie vollständig ersetzt. Alle optionalen Felder, die Sie weglassen, werden auf ihre Standardwerte zurückgesetzt, anstatt die vorhandenen Werte aus der geänderten Richtlinie beizubehalten.

Führen Sie den folgenden Befehl aus, um eine globale VM-Erweiterungsrichtlinie auf Ordnerebene zu aktualisieren:

gcloud preview compute global-vm-extension-policies update POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der zu aktualisierenden VM-Erweiterungsrichtlinie.
• FOLDER_ID: Ihre Google Cloud -Ordner-ID.
• DESCRIPTION: eine optionale Beschreibung der Richtlinie.
• EXTENSION_NAME_1,EXTENSION_NAME_2: Eine durch Kommas getrennte Liste von Erweiterungen, die der Richtlinie hinzugefügt werden sollen. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert die Version der Erweiterung ist. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  Hinweis: Für ops-agent unterstützt VM Extension Manager die Installation von Version 2.58.0 oder neueren Versionen. Für google-cloud-sap-extension und google-cloud-workload-extension unterstützt VM Extension Manager nur die aktuelle Version.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert der Pfad zur Konfigurationsdatei für diese Erweiterung ist. Diese Datei befindet sich auf der VM, auf der Sie den Befehl gcloud ausführen, nicht auf der VM, auf der Sie die Erweiterung installieren.

  Wenn Sie die Konfiguration als Inline-String angeben möchten, verwenden Sie stattdessen das Flag --config anstelle von --config-from-file, z. B. EXTENSION_NAME_1="CONFIG_1". Sie können entweder --config-from-file oder --config verwenden, aber nicht beide im selben Befehl.

• KEY_1=VALUE_1: eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Einschlusslabels für einen Selektor definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die einem der angegebenen Selektoren entsprechen (logisches ODER). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für alle VMs in allen untergeordneten Projekten und Zonen innerhalb des Ordners.
• PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.
• ROLLOUT_PLAN: Geben Sie slow_rollout oder fast_rollout an. Wenn Sie einen benutzerdefinierten Roll-out-Plan verwenden möchten, geben Sie das Flag --rollout-custom-plan anstelle von --rollout-predefined-plan im folgenden Format an:

  --rollout-custom-plan=folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Ersetzen Sie Folgendes:

  • FOLDER_ID: der Ordner, in dem der Roll-out-Plan definiert ist.
  • ROLLOUT_PLAN_NAME: der Name des von Ihnen definierten benutzerdefinierten Roll-out-Plans.

  Wenn Sie kein Flag für den Roll-out-Plan angeben, verwendet der VM Extension Manager slow_rollout.

• ROLLOUT_CONFLICT_BEHAVIOR: Gibt das Verhalten an, wenn VM Extension Manager einen Konflikt zwischen einer zonalen und einer globalen Richtlinie erkennt. Sie können eines der folgenden Konfliktverhalten angeben:
  • "" (leerer String): Die globale Richtlinie überschreibt keine in Konflikt stehenden zonalen Richtlinien mit demselben Namen. Dieses Konfliktverhalten ist die Standardeinstellung.
  • overwrite: Die globale Richtlinie überschreibt alle zonalen Richtlinien mit demselben Namen. Anschließend werden die Richtlinien-Roll-outs in der Zone über die globale Richtlinie verwaltet.

  Weitere Informationen finden Sie unter dem Flag --rollout-conflict-behavior.

• RETRY_UUID: eine UUID, die einen Wiederholungsversuch für die Einführung eines Richtlinienupdates identifiziert. Mit dieser UUID können Sie eine Aktualisierung ohne Änderungen wiederholen. Wenn Sie dieses Flag festlegen und die Richtlinie geändert wird, tritt ein Fehler auf. Weitere Informationen finden Sie unter Roll-out wiederholen.

REST

Wenn Sie eine ordnerbezogene globale Erweiterungsrichtlinie aktualisieren möchten, senden Sie eine PATCH-Anfrage an die Methode folderGlobalVmExtensionPolicies.update. Wenn Sie eine Richtlinie mit REST aktualisieren, müssen Sie nur die Felder angeben, die Sie aktualisieren möchten. Alle Felder, die Sie weglassen, behalten ihre vorhandenen Werte bei.

PATCH https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

Ersetzen Sie Folgendes:

• FOLDER_ID: Ihre Google Cloud -Ordner-ID.
• POLICY_NAME: der Name der zu aktualisierenden VM-Erweiterungsrichtlinie.
• DESCRIPTION: Eine Beschreibung der VM-Erweiterungsrichtlinie.
• EXTENSION_NAME: der Name der zu aktualisierenden Erweiterung, der als Schlüssel in der extensionPolicies-Zuordnung verwendet wird. Wenn Sie mehrere Erweiterungen aktualisieren möchten, fügen Sie mehrere Einträge in die extensionPolicies-Zuordnung ein.
• EXTENSION_NAME_VERSION: die Version der VM-Erweiterung.
• EXTENSION_NAME_CONFIG: Konfigurationseinstellungen für die VM-Erweiterung als Inline-String.
• KEY_1:VALUE_1, KEY_2:VALUE_2: Schlüssel/Wert-Paare, die Einschlusslabels für eine Auswahl definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie mehrere Selektoren angeben möchten, fügen Sie dem instanceSelectors-Array mehrere Objekte hinzu, jeweils mit einem labelSelector-Feld. In diesem Fall zielt der VM Extension Manager auf VMs ab, die mit einem der angegebenen Selektoren übereinstimmen (logisches ODER). Wenn Sie instanceSelectors weglassen, gilt die Richtlinie für alle VMs in allen untergeordneten Projekten und Zonen innerhalb des Ordners.
• PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.
• ROLLOUT_CONFLICT_BEHAVIOR: Gibt das Verhalten an, wenn VM Extension Manager einen Konflikt zwischen einer zonalen und einer globalen Richtlinie erkennt. Sie können eines der folgenden Konfliktverhalten angeben:
  • "" (leerer String): Die globale Richtlinie überschreibt keine in Konflikt stehenden zonalen Richtlinien mit demselben Namen. Dieses Konfliktverhalten ist die Standardeinstellung.
  • overwrite: Die globale Richtlinie überschreibt alle zonalen Richtlinien mit demselben Namen. Anschließend werden die Richtlinien-Roll-outs in der Zone über die globale Richtlinie verwaltet.

  Weitere Informationen finden Sie unter dem Flag --rollout-conflict-behavior.

• ROLLOUT_PLAN_NAME: der Name des von Ihnen definierten benutzerdefinierten Roll-out-Plans. Wenn Sie einen vordefinierten Roll-out-Plan verwenden möchten, ersetzen Sie das Feld name durch predefinedRolloutPlan und geben Sie einen der folgenden Werte an:
  • SLOW_ROLLOUT: Die Richtlinie wird über fünf Tage hinweg eingeführt. Dieser vordefinierte Plan ist der Standard-Roll-out-Plan, wenn Sie keinen Plan angeben.
  • FAST_ROLLOUT: Die Richtlinie wird sofort in allen Zonen eingeführt.
• RETRY_UUID: eine UUID, die einen Wiederholungsversuch für die Einführung eines Richtlinienupdates identifiziert.

VM-Erweiterungen in allen Zonen eines Projekts ändern

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-VM-Erweiterungsrichtlinien-Administrator (roles/compute.vmExtensionPolicyAdmin) für Ihr Projekt zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Aktualisieren einer projektbezogenen Erweiterungsrichtlinie benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.vmExtensionPolicies.update, die zum Aktualisieren einer projektbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine globale Erweiterungsrichtlinie auf Projektebene zu aktualisieren:

Console

So aktualisieren Sie eine globale VM-Erweiterungsrichtlinie auf Projektebene in der Google Cloud Console:

1. Rufen Sie in der Google Cloud Console die Seite VM-Erweiterungsrichtlinien auf.

   Zu „VM-Erweiterungsrichtlinien“

2. Klicken Sie auf Globale Richtlinien und wählen Sie die Richtlinie aus, die Sie bearbeiten möchten.
3. Klicken Sie auf Bearbeiten.
4. Geben Sie im Feld Priorität eine Prioritätsnummer an, um Konflikte zwischen Richtlinien zu lösen. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1.000.
5. Führen Sie im Abschnitt Erweiterungen verwalten folgende Schritte aus:
   • Wenn Sie weitere Erweiterungen hinzufügen möchten, klicken Sie auf Erweiterung hinzufügen und wählen Sie die Erweiterung und die Version aus.
   • Wenn Sie eine Erweiterung löschen möchten, die von dieser Richtlinie verwaltet wird, klicken Sie neben dem Namen der Erweiterung auf Löschen.
6. Wenn Sie Labels anwenden möchten, fügen Sie im Abschnitt Ziel-VM-Instanzen Labels für die Ziel-VMs hinzu.
7. Klicken Sie auf Speichern.

Hinweis: Die Google Cloud Console unterstützt das Bearbeiten eines Rollouts nicht. Verwenden Sie zum Bearbeiten eines Roll-outs entweder die gcloud CLI oder die REST API.

gcloud

Verwenden Sie den Befehl gcloud compute global-vm-extension-policies update, um eine vorhandene globale VM-Erweiterungsrichtlinie auf Projektebene zu ändern. Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Richtlinie vollständig ersetzt. Alle optionalen Felder, die Sie weglassen, werden auf ihre Standardwerte zurückgesetzt, anstatt die vorhandenen Werte aus der geänderten Richtlinie beizubehalten.

Führen Sie den folgenden Befehl aus, um eine globale VM-Erweiterungsrichtlinie auf Projektebene zu aktualisieren:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der zu aktualisierenden VM-Erweiterungsrichtlinie.
• PROJECT_ID: Projekt-ID in Google Cloud .
• DESCRIPTION: eine optionale Beschreibung der Richtlinie.
• EXTENSION_NAME_1,EXTENSION_NAME_2: Eine durch Kommas getrennte Liste von Erweiterungen, die der Richtlinie hinzugefügt werden sollen. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert die Version der Erweiterung ist. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  Hinweis: Für ops-agent unterstützt VM Extension Manager die Installation von Version 2.58.0 oder neueren Versionen. Für google-cloud-sap-extension und google-cloud-workload-extension unterstützt VM Extension Manager nur die aktuelle Version.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert der Pfad zur Konfigurationsdatei für diese Erweiterung ist. Diese Datei befindet sich auf der VM, auf der Sie den Befehl gcloud ausführen, nicht auf der VM, auf der Sie die Erweiterung installieren.

  Wenn Sie die Konfiguration als Inline-String angeben möchten, verwenden Sie stattdessen das Flag --config anstelle von --config-from-file, z. B. EXTENSION_NAME_1="CONFIG_1". Sie können entweder --config-from-file oder --config verwenden, aber nicht beide im selben Befehl.

• KEY_1=VALUE_1: eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Einschlusslabels für einen Selektor definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die einem der angegebenen Selektoren entsprechen (logisches ODER). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für alle VMs in allen Zonen im Projekt.
• PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.
• ROLLOUT_PLAN: Geben Sie slow_rollout oder fast_rollout an. Wenn Sie einen benutzerdefinierten Roll-out-Plan verwenden möchten, geben Sie das Flag --rollout-custom-plan anstelle von --rollout-predefined-plan im folgenden Format an:

  --rollout-custom-plan=projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Ersetzen Sie Folgendes:

  • PROJECT_NUMBER: das Projekt, in dem der Roll-out-Plan definiert ist.
  • ROLLOUT_PLAN_NAME: der Name des von Ihnen definierten benutzerdefinierten Roll-out-Plans.

  Wenn Sie kein Flag für den Roll-out-Plan angeben, verwendet der VM Extension Manager slow_rollout.

• ROLLOUT_CONFLICT_BEHAVIOR: Gibt das Verhalten an, wenn VM Extension Manager einen Konflikt zwischen einer zonalen und einer globalen Richtlinie erkennt. Sie können eines der folgenden Konfliktverhalten angeben:
  • "" (leerer String): Die globale Richtlinie überschreibt keine in Konflikt stehenden zonalen Richtlinien mit demselben Namen. Dieses Konfliktverhalten ist die Standardeinstellung.
  • overwrite: Die globale Richtlinie überschreibt alle zonalen Richtlinien mit demselben Namen. Anschließend werden die Richtlinien-Roll-outs in der Zone über die globale Richtlinie verwaltet.

  Weitere Informationen finden Sie unter dem Flag --rollout-conflict-behavior.

• RETRY_UUID: eine UUID, die einen Wiederholungsversuch für die Einführung eines Richtlinienupdates identifiziert. Mit dieser UUID können Sie eine Aktualisierung ohne Änderungen wiederholen. Wenn Sie dieses Flag festlegen und die Richtlinie geändert wird, tritt ein Fehler auf. Weitere Informationen finden Sie unter Roll-out wiederholen.

REST

Wenn Sie eine globale Erweiterungsrichtlinie auf Projektebene aktualisieren möchten, senden Sie eine PATCH-Anfrage an die Methode globalVmExtensionPolicies.update. Wenn Sie eine Richtlinie mit REST aktualisieren, müssen Sie nur die Felder angeben, die Sie aktualisieren möchten. Alle Felder, die Sie weglassen, behalten ihre vorhandenen Werte bei.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

Ersetzen Sie Folgendes:

• PROJECT_ID: Projekt-ID in Google Cloud .
• POLICY_NAME: der Name der zu aktualisierenden VM-Erweiterungsrichtlinie.
• DESCRIPTION: Eine Beschreibung der VM-Erweiterungsrichtlinie.
• EXTENSION_NAME: der Name der zu aktualisierenden Erweiterung, der als Schlüssel in der extensionPolicies-Zuordnung verwendet wird. Wenn Sie mehrere Erweiterungen aktualisieren möchten, fügen Sie mehrere Einträge in die extensionPolicies-Zuordnung ein.
• EXTENSION_NAME_VERSION: die Version der VM-Erweiterung.
• EXTENSION_NAME_CONFIG: Konfigurationseinstellungen für die VM-Erweiterung als Inline-String.
• KEY_1:VALUE_1, KEY_2:VALUE_2: Schlüssel/Wert-Paare, die Einschlusslabels für eine Auswahl definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie mehrere Selektoren angeben möchten, fügen Sie dem instanceSelectors-Array mehrere Objekte hinzu, jeweils mit einem labelSelector-Feld. In diesem Fall zielt der VM Extension Manager auf VMs ab, die mit einem der angegebenen Selektoren übereinstimmen (logisches ODER). Wenn Sie instanceSelectors weglassen, gilt die Richtlinie für alle VMs in allen Zonen im Projekt.
• PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.
• ROLLOUT_CONFLICT_BEHAVIOR: Gibt das Verhalten an, wenn VM Extension Manager einen Konflikt zwischen einer zonalen und einer globalen Richtlinie erkennt. Sie können eines der folgenden Konfliktverhalten angeben:
  • "" (leerer String): Die globale Richtlinie überschreibt keine in Konflikt stehenden zonalen Richtlinien mit demselben Namen. Dieses Konfliktverhalten ist die Standardeinstellung.
  • overwrite: Die globale Richtlinie überschreibt alle zonalen Richtlinien mit demselben Namen. Anschließend werden die Richtlinien-Roll-outs in der Zone über die globale Richtlinie verwaltet.

  Weitere Informationen finden Sie unter dem Flag --rollout-conflict-behavior.

• PROJECT_NUMBER: das Projekt, in dem der benutzerdefinierte Roll-out-Plan definiert ist.
• ROLLOUT_PLAN_NAME: der Name des von Ihnen definierten benutzerdefinierten Roll-out-Plans. Wenn Sie einen vordefinierten Roll-out-Plan verwenden möchten, ersetzen Sie das Feld name durch predefinedRolloutPlan und geben Sie einen der folgenden Werte an:
  • SLOW_ROLLOUT: Die Richtlinie wird über fünf Tage hinweg eingeführt. Dieser vordefinierte Plan ist der Standard-Roll-out-Plan, wenn Sie keinen Plan angeben.
  • FAST_ROLLOUT: Die Richtlinie wird sofort in allen Zonen eingeführt.
• RETRY_UUID: eine UUID, die einen Wiederholungsversuch für die Einführung eines Richtlinienupdates identifiziert.

VM-Erweiterungen in einer Zone in einer Organisation ändern

Vorschau

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) für Ihre Organisation zu gewähren, um die Berechtigung zu erhalten, die Sie zum Aktualisieren einer organisationsweiten Erweiterungsrichtlinie benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.orgVmExtensionPolicies.update, die zum Aktualisieren einer organisationsweiten Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine zonale Erweiterungsrichtlinie auf Organisationsebene zu aktualisieren:

gcloud

Verwenden Sie den Befehl gcloud preview compute zone-vm-extension-policies update mit dem Flag --organization, um eine vorhandene zonale VM-Erweiterungsrichtlinie auf Organisationsebene zu ändern. Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Richtlinie durch die Anfrage vollständig ersetzt. Alle optionalen Felder, die Sie weglassen, werden auf ihre Standardwerte zurückgesetzt, anstatt die vorhandenen Werte aus der geänderten Richtlinie beizubehalten.

Führen Sie den folgenden Befehl aus, um eine zonale VM-Erweiterungsrichtlinie auf Organisationsebene zu aktualisieren:

gcloud preview compute zone-vm-extension-policies update POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der zu aktualisierenden VM-Erweiterungsrichtlinie.
• ORGANIZATION_ID: Ihre Google Cloud Organisations-ID.
• ZONE: die Google Cloud -Zone, in der die Richtlinie gilt.
• DESCRIPTION: eine optionale Beschreibung der Richtlinie.
• EXTENSION_NAME_1,EXTENSION_NAME_2: Eine durch Kommas getrennte Liste von Erweiterungen, die der Richtlinie hinzugefügt werden sollen. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert die Version der Erweiterung ist. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  Hinweis: Für ops-agent unterstützt VM Extension Manager die Installation von Version 2.58.0 oder neueren Versionen. Für google-cloud-sap-extension und google-cloud-workload-extension unterstützt VM Extension Manager nur die aktuelle Version.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert der Pfad zur Konfigurationsdatei für diese Erweiterung ist. Diese Datei befindet sich auf der VM, auf der Sie den Befehl gcloud ausführen, nicht auf der VM, auf der Sie die Erweiterung installieren.

  Wenn Sie die Konfiguration als Inline-String angeben möchten, verwenden Sie stattdessen das Flag --config anstelle von --config-from-file, z. B. EXTENSION_NAME_1="CONFIG_1". Sie können entweder --config-from-file oder --config verwenden, aber nicht beide im selben Befehl.

• KEY_1=VALUE_1: eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Einschlusslabels für einen Selektor definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die einem der angegebenen Selektoren entsprechen (logisches ODER). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für alle VMs in der angegebenen Zone in allen untergeordneten Projekten der Organisation.
• PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.

REST

Wenn Sie eine zonale Erweiterungsrichtlinie auf Organisationsebene aktualisieren möchten, senden Sie eine PATCH-Anfrage an die Methode organizationZoneVmExtensionPolicies.update. Wenn Sie eine Richtlinie mit REST aktualisieren, müssen Sie nur die Felder angeben, die Sie aktualisieren möchten. Alle Felder, die Sie weglassen, behalten ihre vorhandenen Werte bei.

PATCH https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

Ersetzen Sie Folgendes:

• ORGANIZATION_ID: Ihre Google Cloud Organisations-ID.
• ZONE: die Google Cloud -Zone, in der sich die VM-Erweiterungsrichtlinie befindet.
• POLICY_NAME: der Name der zu aktualisierenden VM-Erweiterungsrichtlinie.
• DESCRIPTION: Eine Beschreibung der VM-Erweiterungsrichtlinie.
• EXTENSION_NAME: der Name der zu aktualisierenden Erweiterung, der als Schlüssel in der extensionPolicies-Zuordnung verwendet wird. Wenn Sie mehrere Erweiterungen aktualisieren möchten, fügen Sie mehrere Einträge in die extensionPolicies-Zuordnung ein.
• EXTENSION_NAME_VERSION: die Version der VM-Erweiterung.
• EXTENSION_NAME_CONFIG: Konfigurationseinstellungen für die VM-Erweiterung als Inline-String.
• KEY_1:VALUE_1, KEY_2:VALUE_2: Schlüssel/Wert-Paare, die Einschlusslabels für eine Auswahl definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie mehrere Selektoren angeben möchten, fügen Sie dem instanceSelectors-Array mehrere Objekte hinzu, jeweils mit einem labelSelector-Feld. In diesem Fall zielt der VM Extension Manager auf VMs ab, die mit einem der angegebenen Selektoren übereinstimmen (logisches ODER). Wenn Sie instanceSelectors weglassen, gilt die Richtlinie für alle VMs in der angegebenen Zone in allen untergeordneten Projekten der Organisation.
• PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.

VM-Erweiterungen in einer Zone in einem Ordner ändern

Vorschau

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Folder level Compute VM extension policies admin (roles/compute.folderVmExtensionPolicyAdmin) für Ihren Ordner zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Aktualisieren einer ordnerbezogenen Erweiterungsrichtlinie benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.folderVmExtensionPolicies.update, die zum Aktualisieren einer ordnerbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine zonale Erweiterungsrichtlinie auf Ordnerebene zu aktualisieren:

gcloud

Verwenden Sie den Befehl gcloud preview compute zone-vm-extension-policies update mit dem Flag --folder, um eine vorhandene zonale VM-Erweiterungsrichtlinie auf Ordnerebene zu ändern. Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Richtlinie durch die Anfrage vollständig ersetzt. Alle optionalen Felder, die Sie weglassen, werden auf ihre Standardwerte zurückgesetzt, anstatt die vorhandenen Werte aus der geänderten Richtlinie beizubehalten.

Führen Sie den folgenden Befehl aus, um eine zonale VM-Erweiterungsrichtlinie auf Ordnerebene zu aktualisieren:

gcloud preview compute zone-vm-extension-policies update POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der zu aktualisierenden VM-Erweiterungsrichtlinie.
• FOLDER_ID: Ihre Google Cloud -Ordner-ID.
• ZONE: die Google Cloud -Zone, in der die Richtlinie gilt.
• DESCRIPTION: eine optionale Beschreibung der Richtlinie.
• EXTENSION_NAME_1,EXTENSION_NAME_2: Eine durch Kommas getrennte Liste von Erweiterungen, die der Richtlinie hinzugefügt werden sollen. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert die Version der Erweiterung ist. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  Hinweis: Für ops-agent unterstützt VM Extension Manager die Installation von Version 2.58.0 oder neueren Versionen. Für google-cloud-sap-extension und google-cloud-workload-extension unterstützt VM Extension Manager nur die aktuelle Version.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert der Pfad zur Konfigurationsdatei für diese Erweiterung ist. Diese Datei befindet sich auf der VM, auf der Sie den Befehl gcloud ausführen, nicht auf der VM, auf der Sie die Erweiterung installieren.

  Wenn Sie die Konfiguration als Inline-String angeben möchten, verwenden Sie stattdessen das Flag --config anstelle von --config-from-file, z. B. EXTENSION_NAME_1="CONFIG_1". Sie können entweder --config-from-file oder --config verwenden, aber nicht beide im selben Befehl.

• KEY_1=VALUE_1: eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Einschlusslabels für einen Selektor definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die einem der angegebenen Selektoren entsprechen (logisches ODER). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für alle VMs in der angegebenen Zone in allen untergeordneten Projekten im Ordner.
• PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.

REST

Wenn Sie eine zonale Erweiterungsrichtlinie auf Ordnerebene aktualisieren möchten, senden Sie eine PATCH-Anfrage an die Methode folderZoneVmExtensionPolicies.update. Wenn Sie eine Richtlinie mit REST aktualisieren, müssen Sie nur die Felder angeben, die Sie aktualisieren möchten. Alle Felder, die Sie weglassen, behalten ihre vorhandenen Werte bei.

PATCH https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

Ersetzen Sie Folgendes:

• FOLDER_ID: Ihre Google Cloud -Ordner-ID.
• ZONE: die Google Cloud -Zone, in der sich die VM-Erweiterungsrichtlinie befindet.
• POLICY_NAME: der Name der zu aktualisierenden VM-Erweiterungsrichtlinie.
• DESCRIPTION: Eine Beschreibung der VM-Erweiterungsrichtlinie.
• EXTENSION_NAME: der Name der zu aktualisierenden Erweiterung, der als Schlüssel in der extensionPolicies-Zuordnung verwendet wird. Wenn Sie mehrere Erweiterungen aktualisieren möchten, fügen Sie mehrere Einträge in die extensionPolicies-Zuordnung ein.
• EXTENSION_NAME_VERSION: die Version der VM-Erweiterung.
• EXTENSION_NAME_CONFIG: Konfigurationseinstellungen für die VM-Erweiterung als Inline-String.
• KEY_1:VALUE_1, KEY_2:VALUE_2: Schlüssel/Wert-Paare, die Einschlusslabels für eine Auswahl definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie mehrere Selektoren angeben möchten, fügen Sie dem instanceSelectors-Array mehrere Objekte hinzu, jeweils mit einem labelSelector-Feld. In diesem Fall zielt der VM Extension Manager auf VMs ab, die mit einem der angegebenen Selektoren übereinstimmen (logisches ODER). Wenn Sie instanceSelectors weglassen, gilt die Richtlinie für alle VMs in der angegebenen Zone in allen untergeordneten Projekten im Ordner.
• PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.

VM-Erweiterungen in einer Zone in einem Projekt ändern

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-VM-Erweiterungsrichtlinien-Administrator (roles/compute.vmExtensionPolicyAdmin) für Ihr Projekt zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Aktualisieren einer projektbezogenen Erweiterungsrichtlinie benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.vmExtensionPolicies.update, die zum Aktualisieren einer projektbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine zonale Erweiterungsrichtlinie auf Projektebene zu aktualisieren:

Console

So aktualisieren Sie eine zonale VM-Erweiterungsrichtlinie mit Projektbereich in der Google Cloud Console:

1. Rufen Sie in der Google Cloud Console die Seite VM-Erweiterungsrichtlinien auf.

   Zu „VM-Erweiterungsrichtlinien“

2. Wählen Sie die Richtlinie aus, die Sie aktualisieren möchten.
3. Klicken Sie auf Bearbeiten.
4. Ändern Sie die Beschreibung, die Priorität, die Erweiterungen oder die Ziel-VM-Instanzen.
5. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl gcloud compute zone-vm-extension-policies update, um eine vorhandene zonale VM-Erweiterungsrichtlinie auf Projektebene zu ändern. Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Richtlinie durch die Anfrage vollständig ersetzt. Alle optionalen Felder, die Sie weglassen, werden auf ihre Standardwerte zurückgesetzt, anstatt die vorhandenen Werte aus der geänderten Richtlinie beizubehalten.

Führen Sie den folgenden Befehl aus, um eine zonale VM-Erweiterungsrichtlinie auf Projektebene zu aktualisieren:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der zu aktualisierenden VM-Erweiterungsrichtlinie.
• PROJECT_ID: Projekt-ID in Google Cloud .
• ZONE: die Google Cloud -Zone, in der die Richtlinie gilt.
• DESCRIPTION: eine optionale Beschreibung der Richtlinie.
• EXTENSION_NAME_1,EXTENSION_NAME_2: Eine durch Kommas getrennte Liste von Erweiterungen, die der Richtlinie hinzugefügt werden sollen. Sie müssen mindestens eine Erweiterung angeben. Sie können eine der folgenden unterstützten Erweiterungen angeben:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert die Version der Erweiterung ist. Wenn Sie keine Version für eine Erweiterung angeben, verwendet VM Extension Manager die neueste verfügbare Version und aktualisiert sie automatisch, wenn neue Versionen verfügbar sind.
  Hinweis: Für ops-agent unterstützt VM Extension Manager die Installation von Version 2.58.0 oder neueren Versionen. Für google-cloud-sap-extension und google-cloud-workload-extension unterstützt VM Extension Manager nur die aktuelle Version.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, wobei der Schlüssel der Name der Erweiterung und der Wert der Pfad zur Konfigurationsdatei für diese Erweiterung ist. Diese Datei befindet sich auf der VM, auf der Sie den Befehl gcloud ausführen, nicht auf der VM, auf der Sie die Erweiterung installieren.

  Wenn Sie die Konfiguration als Inline-String angeben möchten, verwenden Sie stattdessen das Flag --config anstelle von --config-from-file, z. B. EXTENSION_NAME_1="CONFIG_1". Sie können entweder --config-from-file oder --config verwenden, aber nicht beide im selben Befehl.

• KEY_1=VALUE_1: eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Einschlusslabels für einen Selektor definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie --inclusion-labels mehrmals angeben, gilt die Richtlinie für VMs, die einem der angegebenen Selektoren entsprechen (logisches ODER). Wenn Sie dieses Flag weglassen, gilt die Richtlinie für alle VMs in der angegebenen Zone in Ihrem Projekt.
• PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.

REST

Wenn Sie eine zonale Erweiterungsrichtlinie auf Projektebene aktualisieren möchten, senden Sie eine PATCH-Anfrage an die Methode zoneVmExtensionPolicies.update. Wenn Sie eine Richtlinie mit REST aktualisieren, müssen Sie nur die Felder angeben, die Sie aktualisieren möchten. Alle Felder, die Sie weglassen, behalten ihre vorhandenen Werte bei.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

Ersetzen Sie Folgendes:

• PROJECT_ID: Projekt-ID in Google Cloud .
• ZONE: die Google Cloud -Zone, in der sich die VM-Erweiterungsrichtlinie befindet.
• POLICY_NAME: der Name der zu aktualisierenden VM-Erweiterungsrichtlinie.
• DESCRIPTION: Eine Beschreibung der VM-Erweiterungsrichtlinie.
• EXTENSION_NAME: der Name der zu aktualisierenden Erweiterung, der als Schlüssel in der extensionPolicies-Zuordnung verwendet wird. Wenn Sie mehrere Erweiterungen aktualisieren möchten, fügen Sie mehrere Einträge in die extensionPolicies-Zuordnung ein.
• EXTENSION_NAME_VERSION: die Version der VM-Erweiterung.
• EXTENSION_NAME_CONFIG: Konfigurationseinstellungen für die VM-Erweiterung als Inline-String.
• KEY_1:VALUE_1, KEY_2:VALUE_2: Schlüssel/Wert-Paare, die Einschlusslabels für eine Auswahl definieren. VMs müssen alle angegebenen Labels in einem Selektor enthalten, um als Ziel verwendet zu werden. Wenn Sie mehrere Selektoren angeben möchten, fügen Sie dem instanceSelectors-Array mehrere Objekte hinzu, jeweils mit einem labelSelector-Feld. In diesem Fall zielt der VM Extension Manager auf VMs ab, die mit einem der angegebenen Selektoren übereinstimmen (logisches ODER). Wenn Sie instanceSelectors weglassen, gilt die Richtlinie für alle VMs in der angegebenen Zone in Ihrem Projekt.
• PRIORITY: Eine Ganzzahl von 0 bis 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Wenn mehrere Richtlinien dieselbe Priorität haben, wendet der VM Extension Manager die zuletzt aktualisierte Richtlinie auf die VMs an.

Erweiterungen durch Löschen einer VM-Erweiterungsrichtlinie deinstallieren

Wenn Sie eine Richtlinie löschen, deinstalliert VM Extension Manager die Erweiterungen von allen VMs, die von dieser Richtlinie verwaltet werden. Wenn jedoch eine andere aktive Richtlinie mit niedrigerer Priorität für eine VM gilt und dieselbe Erweiterung deklariert, bleibt die Erweiterung gemäß der Richtlinie mit niedrigerer Priorität auf dieser VM installiert.

VM Extension Manager entfernt Erweiterungen innerhalb einer Minute nach dem Löschen der Richtlinie von allen zugänglichen VMs. Wenn eine VM nicht zugänglich ist, weil der Gast-Agent entfernt oder die VM gelöscht wurde, überspringt VM Extension Manager das Löschen der Erweiterung. Wenn eine solche VM wieder verfügbar ist, entfernt der VM Extension Manager die Erweiterungen zu diesem Zeitpunkt.

VM-Erweiterungen in allen Zonen einer Organisation deinstallieren

Vorschau

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) für Ihre Organisation zu gewähren, um die Berechtigung zum Löschen einer organisationsweiten Erweiterungsrichtlinie zu erhalten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.orgVmExtensionPolicies.delete, die zum Löschen einer organisationsbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine globale Erweiterungsrichtlinie auf Organisationsebene zu löschen:

gcloud

Verwenden Sie den Befehl gcloud preview compute global-vm-extension-policies delete mit dem Flag --organization, um eine vorhandene globale VM-Erweiterungsrichtlinie auf Organisationsebene zu löschen:

gcloud preview compute global-vm-extension-policies delete POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie löschen möchten.
• ORGANIZATION_ID: die ID Ihrer Organisation in Google Cloud .
• ROLLOUT_PLAN: Geben Sie slow_rollout oder fast_rollout an. Wenn Sie einen benutzerdefinierten Roll-out-Plan verwenden möchten, geben Sie das Flag --rollout-custom-plan anstelle von --rollout-predefined-plan im folgenden Format an:

  --rollout-custom-plan=organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Ersetzen Sie Folgendes:

  • ORGANIZATION_ID: die Organisation, in der der Roll-out-Plan definiert ist.
  • ROLLOUT_PLAN_NAME: der Name des von Ihnen definierten benutzerdefinierten Roll-out-Plans.

  Wenn Sie kein Flag für den Roll-out-Plan angeben, verwendet der VM Extension Manager slow_rollout.

• RETRY_UUID: Eine UUID, um das Löschen einer Erweiterungsrichtlinie noch einmal zu versuchen. Legen Sie dieses Feld nur fest, wenn Sie eine Löschanfrage für eine vorhandene Richtlinie im Status DELETING wiederholen. Wenn Sie dieses Feld festlegen, während die Richtlinie nicht den Status DELETING hat, wird ein Fehler verursacht. Weitere Informationen finden Sie unter Roll-out wiederholen.

REST

Wenn Sie eine globale Erweiterungsrichtlinie auf Organisationsebene löschen möchten, senden Sie eine POST-Anfrage an die Methode organizationGlobalVmExtensionPolicies.delete.

POST https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensionPolicies/POLICY_NAME/delete

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie löschen möchten.
• ORGANIZATION_ID: Ihre Google Cloud Organisations-ID.
• ROLLOUT_PLAN: Geben Sie SLOW_ROLLOUT oder FAST_ROLLOUT an. Wenn Sie einen benutzerdefinierten Roll-out-Plan verwenden möchten, ersetzen Sie predefinedRolloutPlan durch "name": "organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME".
• RETRY_UUID: Eine UUID, um das Löschen einer Erweiterungsrichtlinie noch einmal zu versuchen. Legen Sie dieses Feld nur fest, wenn Sie eine Löschanfrage für eine vorhandene Richtlinie im Status DELETING wiederholen. Wenn Sie dieses Feld festlegen, während die Richtlinie nicht den Status DELETING hat, wird ein Fehler verursacht. Weitere Informationen finden Sie unter Roll-out wiederholen.

VM-Erweiterungen in allen Zonen in einem Ordner deinstallieren

Vorschau

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Folder level Compute VM extension policies admin (roles/compute.folderVmExtensionPolicyAdmin) für Ihren Ordner zuzuweisen, um die Berechtigung zum Löschen einer ordnerbezogenen Erweiterungsrichtlinie zu erhalten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.folderVmExtensionPolicies.delete, die zum Löschen einer ordnerbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine globale Erweiterungsrichtlinie auf Ordnerebene zu löschen:

gcloud

Verwenden Sie den Befehl gcloud preview compute global-vm-extension-policies delete mit dem Flag --folder, um eine vorhandene globale VM-Erweiterungsrichtlinie auf Ordnerebene zu löschen:

gcloud preview compute global-vm-extension-policies delete POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie löschen möchten.
• FOLDER_ID: die ID Ihres Ordners in Google Cloud .
• ROLLOUT_PLAN: Geben Sie slow_rollout oder fast_rollout an. Wenn Sie einen benutzerdefinierten Roll-out-Plan verwenden möchten, geben Sie das Flag --rollout-custom-plan anstelle von --rollout-predefined-plan im folgenden Format an:

  --rollout-custom-plan=folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Ersetzen Sie Folgendes:

  • FOLDER_ID: der Ordner, in dem der Roll-out-Plan definiert ist.
  • ROLLOUT_PLAN_NAME: der Name des von Ihnen definierten benutzerdefinierten Roll-out-Plans.

  Wenn Sie kein Flag für den Roll-out-Plan angeben, verwendet der VM Extension Manager slow_rollout.

• RETRY_UUID: Eine UUID, um das Löschen einer Erweiterungsrichtlinie noch einmal zu versuchen. Legen Sie dieses Feld nur fest, wenn Sie eine Löschanfrage für eine vorhandene Richtlinie im Status DELETING wiederholen. Wenn Sie dieses Feld festlegen, während die Richtlinie nicht den Status DELETING hat, wird ein Fehler verursacht. Weitere Informationen finden Sie unter Roll-out wiederholen.

REST

Wenn Sie eine globale Erweiterungsrichtlinie auf Ordnerebene löschen möchten, senden Sie eine POST-Anfrage an die Methode folderGlobalVmExtensionPolicies.delete.

POST https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensionPolicies/POLICY_NAME/delete

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie löschen möchten.
• FOLDER_ID: Ihre Google Cloud -Ordner-ID.
• ROLLOUT_PLAN: Geben Sie SLOW_ROLLOUT oder FAST_ROLLOUT an. Wenn Sie einen benutzerdefinierten Roll-out-Plan verwenden möchten, ersetzen Sie predefinedRolloutPlan durch "name": "folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME".
• RETRY_UUID: Eine UUID, um das Löschen einer Erweiterungsrichtlinie noch einmal zu versuchen. Legen Sie dieses Feld nur fest, wenn Sie eine Löschanfrage für eine vorhandene Richtlinie im Status DELETING wiederholen. Wenn Sie dieses Feld festlegen, während die Richtlinie nicht den Status DELETING hat, wird ein Fehler verursacht. Weitere Informationen finden Sie unter Roll-out wiederholen.

VM-Erweiterungen in allen Zonen eines Projekts deinstallieren

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute VM extension policies admin (roles/compute.vmExtensionPolicyAdmin) für Ihr Projekt zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Löschen einer projektbezogenen Erweiterungsrichtlinie benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.vmExtensionPolicies.delete, die zum Löschen einer projektbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine globale Erweiterungsrichtlinie auf Projektebene zu löschen:

Console

So löschen Sie eine globale VM-Erweiterungsrichtlinie auf Projektebene in der Google Cloud Console:

1. Rufen Sie in der Google Cloud Console die Seite VM-Erweiterungsrichtlinien auf.

   Zu „VM-Erweiterungsrichtlinien“

2. Klicken Sie auf Globale Richtlinien und wählen Sie die Richtlinie aus, die Sie löschen möchten.
3. Klicken Sie auf Löschen.
4. Geben Sie im Bestätigungsdialogfeld den Namen der Richtlinie ein und klicken Sie dann auf Löschen.

gcloud

Verwenden Sie den Befehl gcloud compute global-vm-extension-policies delete, um eine vorhandene globale VM-Erweiterungsrichtlinie auf Projektebene zu löschen:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie löschen möchten.
• PROJECT_ID: die ID Ihres Projekts in Google Cloud .
• ROLLOUT_PLAN: Geben Sie slow_rollout oder fast_rollout an. Wenn Sie einen benutzerdefinierten Roll-out-Plan verwenden möchten, geben Sie das Flag --rollout-custom-plan anstelle von --rollout-predefined-plan im folgenden Format an:

  --rollout-custom-plan=projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Ersetzen Sie Folgendes:

  • PROJECT_NUMBER: das Projekt, in dem der Roll-out-Plan definiert ist.
  • ROLLOUT_PLAN_NAME: der Name des von Ihnen definierten benutzerdefinierten Roll-out-Plans.

  Wenn Sie kein Flag für den Roll-out-Plan angeben, verwendet der VM Extension Manager slow_rollout.

• RETRY_UUID: Eine UUID, um das Löschen einer Erweiterungsrichtlinie noch einmal zu versuchen. Legen Sie dieses Feld nur fest, wenn Sie eine Löschanfrage für eine vorhandene Richtlinie im Status DELETING wiederholen. Wenn Sie dieses Feld festlegen, während die Richtlinie nicht den Status DELETING hat, wird ein Fehler verursacht. Weitere Informationen finden Sie unter Roll-out wiederholen.

REST

Senden Sie zum Löschen einer globalen Erweiterungsrichtlinie auf Projektebene eine POST-Anfrage an die Methode globalVmExtensionPolicies.delete.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/vmExtensionPolicies/POLICY_NAME/delete

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie löschen möchten.
• PROJECT_ID: Projekt-ID in Google Cloud .
• ROLLOUT_PLAN: Geben Sie SLOW_ROLLOUT oder FAST_ROLLOUT an. Wenn Sie einen benutzerdefinierten Roll-out-Plan verwenden möchten, ersetzen Sie predefinedRolloutPlan durch "name": "projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME".
• RETRY_UUID: Eine UUID, um das Löschen einer Erweiterungsrichtlinie noch einmal zu versuchen. Legen Sie dieses Feld nur fest, wenn Sie eine Löschanfrage für eine vorhandene Richtlinie im Status DELETING wiederholen. Wenn Sie dieses Feld festlegen, während die Richtlinie nicht den Status DELETING hat, wird ein Fehler verursacht. Weitere Informationen finden Sie unter Roll-out wiederholen.

VM-Erweiterungen in einer Zone in einer Organisation deinstallieren

Vorschau

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) für Ihre Organisation zu gewähren, um die Berechtigung zum Löschen einer organisationsweiten Erweiterungsrichtlinie zu erhalten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.orgVmExtensionPolicies.delete, die zum Löschen einer organisationsbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine zonale Erweiterungsrichtlinie auf Organisationsebene zu löschen:

gcloud

Verwenden Sie den Befehl gcloud preview compute zone-vm-extension-policies delete mit dem Flag --organization, um eine vorhandene zonale VM-Erweiterungsrichtlinie auf Organisationsebene zu löschen:

gcloud preview compute zone-vm-extension-policies delete POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie löschen möchten.
• ORGANIZATION_ID: die ID Ihrer Organisation in Google Cloud .
• ZONE: die Google Cloud -Zone, in der sich die Richtlinie befindet.

REST

Wenn Sie eine zonale Erweiterungsrichtlinie auf Organisationsebene löschen möchten, senden Sie eine DELETE-Anfrage an die Methode organizationZoneVmExtensionPolicies.delete.

DELETE https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie löschen möchten.
• ORGANIZATION_ID: Ihre Google Cloud Organisations-ID.
• ZONE: die Google Cloud -Zone, in der sich die Richtlinie befindet.

VM-Erweiterungen in einer Zone in einem Ordner deinstallieren

Vorschau

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Folder level Compute VM extension policies admin (roles/compute.folderVmExtensionPolicyAdmin) für Ihren Ordner zuzuweisen, um die Berechtigung zum Löschen einer ordnerbezogenen Erweiterungsrichtlinie zu erhalten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.folderVmExtensionPolicies.delete, die zum Löschen einer ordnerbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine zonale Erweiterungsrichtlinie auf Ordnerebene zu löschen:

gcloud

Verwenden Sie den Befehl gcloud preview compute zone-vm-extension-policies delete mit dem Flag --folder, um eine vorhandene zonale VM-Erweiterungsrichtlinie mit Ordnerbereich zu löschen:

gcloud preview compute zone-vm-extension-policies delete POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie löschen möchten.
• FOLDER_ID: die ID Ihres Ordners in Google Cloud .
• ZONE: die Google Cloud -Zone, in der sich die Richtlinie befindet.

REST

Wenn Sie eine zonale Erweiterungsrichtlinie auf Ordnerebene löschen möchten, senden Sie eine DELETE-Anfrage an die Methode folderZoneVmExtensionPolicies.delete.

DELETE https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie löschen möchten.
• FOLDER_ID: Ihre Google Cloud -Ordner-ID.
• ZONE: die Google Cloud -Zone, in der sich die Richtlinie befindet.

VM-Erweiterungen in einer Zone in einem Projekt deinstallieren

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute VM extension policies admin (roles/compute.vmExtensionPolicyAdmin) für Ihr Projekt zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Löschen einer projektbezogenen Erweiterungsrichtlinie benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.vmExtensionPolicies.delete, die zum Löschen einer projektbezogenen Erweiterungsrichtlinie erforderlich ist.

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

Wählen Sie eine der folgenden Optionen aus, um eine zonale Erweiterungsrichtlinie auf Projektebene zu löschen:

Console

Führen Sie die folgenden Schritte aus, um eine zonale VM-Erweiterungsrichtlinie auf Projektebene in der Google Cloud Console zu löschen:

1. Rufen Sie in der Google Cloud Console die Seite VM-Erweiterungsrichtlinien auf.

   Zu „VM-Erweiterungsrichtlinien“

2. Wählen Sie die Richtlinie aus, die Sie löschen möchten.
3. Klicken Sie auf Löschen.
4. Klicken Sie im Bestätigungsdialogfeld auf Löschen.

gcloud

Verwenden Sie den Befehl gcloud compute zone-vm-extension-policies delete, um eine vorhandene zonale VM-Erweiterungsrichtlinie auf Projektebene zu löschen:

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie löschen möchten.
• PROJECT_ID: die ID Ihres Projekts in Google Cloud .
• ZONE: die Google Cloud -Zone, in der sich die Richtlinie befindet.

REST

Wenn Sie eine zonale Erweiterungsrichtlinie auf Projektebene löschen möchten, senden Sie eine DELETE-Anfrage an die Methode zoneVmExtensionPolicies.delete.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

Ersetzen Sie Folgendes:

• POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie löschen möchten.
• PROJECT_ID: Projekt-ID in Google Cloud .
• ZONE: die Google Cloud -Zone, in der sich die Richtlinie befindet.

Nächste Schritte

• Informationen zum Prüfen des Roll-out-Fortschritts und des Systemzustands der Erweiterung finden Sie unter Details und Status von VM-Erweiterungen ansehen.
• Informationen zur Diagnose fehlgeschlagener Roll-outs, zur Prüfung laufender Gastprozesse oder zur Prüfung von Debugging-Logs des Gast-Agents finden Sie unter Fehlerbehebung bei VM-Erweiterungen.
• Informationen zum Erstellen von Cloud Monitoring-Dashboards und zum Einrichten von Benachrichtigungen für den Agent-Zustand, die CPU- und die Arbeitsspeichernutzung finden Sie unter VM-Erweiterungen überwachen.
• Informationen zum Abfragen von historischen Erzwingungsereignissen und zum Prüfen von Installations- oder Absturzdatensätzen in Cloud Logging finden Sie unter VM-Erweiterungslogs ansehen.