Details und Status von VM-Erweiterungen ansehen

Sie installieren VM-Erweiterungen auf Compute Engine-VM-Instanzen, indem Sie globale oder zonale Erweiterungsrichtlinien auf Organisations-, Ordner- oder Projektebene erstellen. Mit einer einzelnen Richtlinie können mehrere Erweiterungen auf einer einzelnen VM installiert werden. Außerdem können mehrere Richtlinien auf dieselbe VM angewendet werden.

In diesem Dokument wird beschrieben, wie Sie schreibgeschützte get- und list-Methoden in Ihrer Google Cloud -Ressourcenhierarchie verwenden, um die folgenden Aufgaben auszuführen:

  • Erweiterungsrichtlinien in Ihrer Ressourcenhierarchie ansehen Listen Sie globale oder zonale VM-Erweiterungsrichtlinien auf, um Richtliniendetails und den Roll-out-Status in Ihrer Organisation, Ihrem Ordner oder Ihrem Projekt anzusehen.
  • VM-Erweiterungen und -Versionen ansehen Listen Sie VM-Erweiterungen auf, die von VM Extension Manager unterstützt werden, oder rufen Sie Erweiterungsdetails auf, einschließlich Versionsnummern und Supportstufen, für alle Zonen oder eine bestimmte Zone in Ihrer Organisation, Ihrem Ordner oder Ihrem Projekt.
  • Status der installierten Erweiterungen auf jeder VM ansehen Listen Sie alle installierten VM-Erweiterungen und ihre Laufzeitstatus auf einer Instanz auf, wenn eine Richtlinie mehrere Erweiterungen auf einer VM installiert, oder rufen Sie die endgültige effektive Konfiguration und die geltende Richtlinie (policyId) auf, wenn mehrere Richtlinien für dieselbe VM gelten.
  • Fehlerbehebung bei Erweiterungen auf einer Instanz Sie können den Installationsfortschritt, den Laufzeitstatus und Diagnosemeldungen aufrufen, wenn eine unerwartete Erweiterung installiert wird oder eine Erweiterung auf einer VM-Instanz fehlschlägt.

Hinweis

Bevor Sie VM-Erweiterungsrichtlinien aufrufen, Details zu VM-Erweiterungen abrufen oder Erweiterungsstatus auf Ihren VM-Instanzen prüfen, müssen Sie die folgenden Voraussetzungen erfüllen:

  • Lesen Sie Informationen zu VM Extension Manager, um zu erfahren, wie Erweiterungsrichtlinien Gast-Agent-Plug-ins in Ihrer VM-Flotte verwalten.
  • Wenn Sie noch keine Erweiterungen auf Ihren Instanzen bereitgestellt haben, erstellen Sie zuerst eine Richtlinie. Weitere Informationen finden Sie unter VM-Erweiterungen durch Erstellen von Erweiterungsrichtlinien installieren.
  • Prüfen Sie, ob Sie die erforderlichen IAM-Berechtigungen (Identity and Access Management) haben, um Erweiterungsrichtlinien aufzurufen, Erweiterungsdetails abzurufen und den Status von Instanzerweiterungen zu prüfen.

Einschränkungen beim Aufrufen von Richtlinien und Erweiterungen

Beachten Sie beim Aufrufen von VM-Erweiterungsrichtlinien, Erweiterungsdetails und Instanzstatus die folgenden betrieblichen Einschränkungen:

  • Sie können VM-Erweiterungsrichtlinien auf Ordner- und Organisationsebene nur über die Google Cloud CLI oder die Compute Engine REST API aufrufen.
  • Sie können Details zu VM-Erweiterungen und den Status von Instanzerweiterungen nur über die Google Cloud CLI oder die Compute Engine REST API abrufen. Sie können sich in derGoogle Cloud -Konsole keine Details zu VM-Erweiterungen oder Erweiterungsstatus pro Instanz ansehen.
  • Die APIs für den Instanzerweiterungsstatus (getVmExtensionState und listVmExtensionStates) melden den Laufzeitstatus nur für Erweiterungen, die von VM Extension Manager-Richtlinien installiert und verwaltet werden. Diese APIs melden keinen Status für eigenständige Agents, die Sie manuell außerhalb von VM Extension Manager installieren.

Erweiterungsrichtlinien ansehen

Sie können VM-Erweiterungsrichtlinien auflisten oder die Konfigurationsdetails einer bestimmten Richtlinie auf Organisations-, Ordner- oder Projektebene prüfen.

Globale Erweiterungsrichtlinien für alle Zonen in einer Organisation ansehen

Sie können alle globalen VM-Erweiterungsrichtlinien in Ihrer Organisation auflisten oder eine bestimmte globale Richtlinie auf Organisationsebene prüfen, um die Bereitstellung von Erweiterungen in der gesamten Flotte zu prüfen.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Betrachter von Compute-VM-Erweiterungsrichtlinien auf Organisationsebene (roles/compute.orgVmExtensionPolicyViewer) oder Administrator von Compute-VM-Erweiterungsrichtlinien auf Organisationsebene (roles/compute.orgVmExtensionPolicyAdmin) für Ihre Organisation zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von Erweiterungsrichtlinien auf Organisationsebene benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von organisationsbezogenen Erweiterungsrichtlinien erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um organisationsbezogene Erweiterungsrichtlinien aufzurufen:

  • Erweiterungsrichtlinien auflisten: compute.orgVmExtensionPolicies.list
  • Details einer Erweiterungsrichtlinie ansehen: compute.orgVmExtensionPolicies.get

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

Wählen Sie eine der folgenden Optionen aus, um globale Erweiterungsrichtlinien in einer Organisation aufzurufen:

gcloud

Wenn Sie alle globalen Erweiterungsrichtlinien in einer Organisation aufrufen möchten, führen Sie den Befehl gcloud preview compute global-vm-extension-policies list mit dem Flag --organization aus:

gcloud preview compute global-vm-extension-policies list \
  --organization=organizations/ORGANIZATION_ID \
  --page-size=PAGE_SIZE

Ersetzen Sie Folgendes:

  • ORGANIZATION_ID: die ID Ihrer Organisation in Google Cloud .
  • PAGE_SIZE: die maximale Anzahl von Ergebnissen, die pro Seite zurückgegeben werden sollen.

Führen Sie den Befehl gcloud preview compute global-vm-extension-policies describe mit dem Flag --organization aus, um Details zu einer bestimmten globalen Erweiterungsrichtlinie in einer Organisation aufzurufen:

gcloud preview compute global-vm-extension-policies describe POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID

Ersetzen Sie Folgendes:

  • POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie aufrufen möchten.
  • ORGANIZATION_ID: die ID Ihrer Organisation in Google Cloud .

REST

Wenn Sie alle globalen Erweiterungsrichtlinien in einer Organisation aufrufen möchten, senden Sie eine GET-Anfrage an die Methode organizationGlobalVmExtensionPolicies.list:

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

Wenn Sie Details zu einer bestimmten globalen Erweiterungsrichtlinie in einer Organisation aufrufen möchten, senden Sie eine GET-Anfrage an die Methode organizationGlobalVmExtensionPolicies.get:

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

Ersetzen Sie Folgendes:

  • POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie aufrufen möchten.
  • ORGANIZATION_ID: die ID Ihrer Organisation in Google Cloud .

Globale Erweiterungsrichtlinien für alle Zonen in einem Ordner ansehen

Sie können alle globalen VM-Erweiterungsrichtlinien in einem Ordner auflisten oder eine bestimmte globale Richtlinie auf Ordnerebene prüfen, um festzustellen, welche Erweiterungen für alle Projekte in diesem Ordner gelten.

Erforderliche IAM-Berechtigungen

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

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von Erweiterungsrichtlinien auf Ordnerebene erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um ordnerbezogene Erweiterungsrichtlinien aufzurufen:

  • Erweiterungsrichtlinien auflisten: compute.folderVmExtensionPolicies.list
  • Details einer Erweiterungsrichtlinie ansehen: compute.folderVmExtensionPolicies.get

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

Wählen Sie eine der folgenden Optionen aus, um globale Erweiterungsrichtlinien in einem Ordner aufzurufen:

gcloud

Führen Sie den gcloud preview compute global-vm-extension-policies list-Befehl mit dem Flag --folder aus, um alle globalen Erweiterungsrichtlinien in einem Ordner aufzurufen:

gcloud preview compute global-vm-extension-policies list \
  --folder=folders/FOLDER_ID \
  --page-size=PAGE_SIZE

Ersetzen Sie Folgendes:

  • FOLDER_ID: die ID Ihres Ordners in Google Cloud .
  • PAGE_SIZE: die maximale Anzahl von Ergebnissen, die pro Seite zurückgegeben werden sollen.

Führen Sie den Befehl gcloud preview compute global-vm-extension-policies describe mit dem Flag --folder aus, um Details zu einer bestimmten globalen Erweiterungsrichtlinie in einem Ordner aufzurufen:

gcloud preview compute global-vm-extension-policies describe POLICY_NAME \
  --folder=folders/FOLDER_ID

Ersetzen Sie Folgendes:

  • POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie aufrufen möchten.
  • FOLDER_ID: die ID Ihres Ordners in Google Cloud .

REST

Wenn Sie alle globalen Erweiterungsrichtlinien in einem Ordner aufrufen möchten, senden Sie eine GET-Anfrage an die Methode folderGlobalVmExtensionPolicies.list:

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

Wenn Sie Details zu einer bestimmten globalen Erweiterungsrichtlinie in einem Ordner aufrufen möchten, senden Sie eine GET-Anfrage an die Methode folderGlobalVmExtensionPolicies.get:

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

Ersetzen Sie Folgendes:

  • POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie aufrufen möchten.
  • FOLDER_ID: die ID Ihres Ordners in Google Cloud .

Globale Erweiterungsrichtlinien in allen Zonen eines Projekts ansehen

Sie können globale VM-Erweiterungsrichtlinien in einem Projekt aufrufen, um den Roll-out-Fortschritt zu überwachen und Erweiterungskonfigurationen in allen Zonen dieses Projekts zu prüfen.

Erforderliche IAM-Berechtigungen

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

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von projektbezogenen Erweiterungsrichtlinien erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um projektbezogene Erweiterungsrichtlinien aufzurufen:

  • Erweiterungsrichtlinien auflisten: compute.vmExtensionPolicies.list
  • Details einer Erweiterungsrichtlinie ansehen: compute.vmExtensionPolicies.get

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

Wählen Sie eine der folgenden Optionen aus, um globale Erweiterungsrichtlinien in einem Projekt aufzurufen:

Console

So rufen Sie globale VM-Erweiterungsrichtlinien in Ihrem Projekt über die Google Cloud Console auf:

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

    Zu „VM-Erweiterungsrichtlinien“

  2. Klicken Sie auf Globale Richtlinien. Auf diesem Tab werden alle globalen VM-Erweiterungsrichtlinien in Ihrem Projekt aufgeführt.

gcloud

Führen Sie den Befehl gcloud compute global-vm-extension-policies list aus, um alle globalen Erweiterungsrichtlinien in einem Projekt aufzurufen:

gcloud compute global-vm-extension-policies list \
  --project=PROJECT_ID \
  --page-size=PAGE_SIZE

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
  • PAGE_SIZE: die maximale Anzahl von Ergebnissen, die pro Seite zurückgegeben werden sollen.

Führen Sie den Befehl gcloud compute global-vm-extension-policies describe aus, um Details zu einer bestimmten globalen Erweiterungsrichtlinie in einem Projekt aufzurufen:

gcloud compute global-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID

Ersetzen Sie Folgendes:

  • POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie aufrufen möchten.
  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .

REST

Wenn Sie alle globalen Erweiterungsrichtlinien in einem Projekt aufrufen möchten, senden Sie eine GET-Anfrage an die Methode globalVmExtensionPolicies.list:

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

Wenn Sie Details zu einer bestimmten globalen Erweiterungsrichtlinie in einem Projekt aufrufen möchten, senden Sie eine GET-Anfrage an die Methode globalVmExtensionPolicies.get:

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

Ersetzen Sie Folgendes:

  • POLICY_NAME: der Name der VM-Erweiterungsrichtlinie, die Sie aufrufen möchten.
  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .

Zonale Erweiterungsrichtlinien in einer Zone in einer Organisation ansehen

Sie können VM-Erweiterungsrichtlinien auf Organisationsebene in einer bestimmten Zone auflisten oder eine einzelne Richtlinie prüfen, um die Durchsetzungsregeln auf Zonenebene in Ihrer Organisation zu prüfen.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Betrachter von Compute-VM-Erweiterungsrichtlinien auf Organisationsebene (roles/compute.orgVmExtensionPolicyViewer) oder Administrator von Compute-VM-Erweiterungsrichtlinien auf Organisationsebene (roles/compute.orgVmExtensionPolicyAdmin) für Ihre Organisation zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von Erweiterungsrichtlinien auf Organisationsebene benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von organisationsbezogenen Erweiterungsrichtlinien erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um organisationsbezogene Erweiterungsrichtlinien aufzurufen:

  • Erweiterungsrichtlinien auflisten: compute.orgVmExtensionPolicies.list
  • Details einer Erweiterungsrichtlinie ansehen: compute.orgVmExtensionPolicies.get

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

Wählen Sie eine der folgenden Optionen aus, um zonale Erweiterungsrichtlinien in einer Organisation aufzurufen:

gcloud

Führen Sie den Befehl gcloud preview compute zone-vm-extension-policies list mit dem Flag --organization aus, um alle organisationsbezogenen Erweiterungsrichtlinien in einer Zone aufzurufen:

gcloud preview compute zone-vm-extension-policies list \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

Ersetzen Sie Folgendes:

  • ORGANIZATION_ID: die ID Ihrer Organisation in Google Cloud .
  • ZONE: der Name der Zone, in der Sie VM-Erweiterungsrichtlinien auflisten möchten.
  • PAGE_SIZE: die maximale Anzahl von Ergebnissen, die pro Seite zurückgegeben werden sollen.

Führen Sie den Befehl gcloud preview compute zone-vm-extension-policies describe mit dem Flag --organization aus, um Details zu einer bestimmten zonalen Erweiterungsrichtlinie auf Organisationsebene aufzurufen:

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

Ersetzen Sie Folgendes:

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

REST

Wenn Sie alle zonalen Erweiterungsrichtlinien in einer Organisation aufrufen möchten, senden Sie eine GET-Anfrage an die Methode organizationZoneVmExtensionPolicies.list:

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

Wenn Sie Details zu einer bestimmten zonalen Erweiterungsrichtlinie in einer Organisation aufrufen möchten, senden Sie eine GET-Anfrage an die Methode organizationZoneVmExtensionPolicies.get:

GET 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 aufrufen möchten.
  • ORGANIZATION_ID: die ID Ihrer Organisation in Google Cloud .
  • ZONE: die Google Cloud -Zone, in der sich die VM-Erweiterungsrichtlinie befindet.

Zonale Erweiterungsrichtlinien in einer Zone in einem Ordner ansehen

Sie können VM-Erweiterungsrichtlinien auf Ordnerebene in einer bestimmten Zone auflisten oder eine einzelne Richtlinie prüfen, um die Erweiterungsregeln auf Zonenebene für Projekte in Ihrem Ordner zu verifizieren.

Erforderliche IAM-Berechtigungen

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

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von Erweiterungsrichtlinien auf Ordnerebene erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um ordnerbezogene Erweiterungsrichtlinien aufzurufen:

  • Erweiterungsrichtlinien auflisten: compute.folderVmExtensionPolicies.list
  • Details einer Erweiterungsrichtlinie ansehen: compute.folderVmExtensionPolicies.get

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

Wählen Sie eine der folgenden Optionen aus, um zonale Erweiterungsrichtlinien in einem Ordner aufzurufen:

gcloud

Führen Sie den Befehl gcloud preview compute zone-vm-extension-policies list mit dem Flag --folder aus, um alle ordnerbezogenen Erweiterungsrichtlinien in einer Zone aufzurufen:

gcloud preview compute zone-vm-extension-policies list \
  --folder=folders/FOLDER_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

Ersetzen Sie Folgendes:

  • FOLDER_ID: die ID Ihres Ordners in Google Cloud .
  • ZONE: der Name der Zone, in der Sie VM-Erweiterungsrichtlinien auflisten möchten.
  • PAGE_SIZE: die maximale Anzahl von Ergebnissen, die pro Seite zurückgegeben werden sollen.

Führen Sie den Befehl gcloud preview compute zone-vm-extension-policies describe mit dem Flag --folder aus, um Details zu einer bestimmten zonalen Erweiterungsrichtlinie auf Ordnerebene aufzurufen:

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

Ersetzen Sie Folgendes:

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

REST

Wenn Sie alle zonalen Erweiterungsrichtlinien in einem Ordner aufrufen möchten, senden Sie eine GET-Anfrage an die Methode folderZoneVmExtensionPolicies.list:

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

Wenn Sie Details zu einer bestimmten zonalen Erweiterungsrichtlinie in einem Ordner aufrufen möchten, senden Sie eine GET-Anfrage an die Methode folderZoneVmExtensionPolicies.get:

GET 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 aufrufen möchten.
  • FOLDER_ID: die ID Ihres Ordners in Google Cloud .
  • ZONE: die Google Cloud -Zone, in der sich die VM-Erweiterungsrichtlinie befindet.

Zonale Erweiterungsrichtlinien in einer Zone in einem Projekt ansehen

Sie können projektbezogene VM-Erweiterungsrichtlinien in einer bestimmten Zone auflisten oder eine einzelne Richtlinie prüfen, um festzustellen, welche Erweiterungen für Instanzen in dieser Zone gelten.

Erforderliche IAM-Berechtigungen

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

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von projektbezogenen Erweiterungsrichtlinien erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um projektbezogene Erweiterungsrichtlinien aufzurufen:

  • Erweiterungsrichtlinien auflisten: compute.vmExtensionPolicies.list
  • Details einer Erweiterungsrichtlinie ansehen: compute.vmExtensionPolicies.get

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

Wählen Sie eine der folgenden Optionen aus, um zonale Erweiterungsrichtlinien in einem Projekt aufzurufen:

Console

So rufen Sie zonale VM-Erweiterungsrichtlinien in Ihrem Projekt über die Google Cloud Console auf:

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

    Zu „VM-Erweiterungsrichtlinien“

  2. Klicken Sie auf den Namen der Richtlinie, um Details zu einer bestimmten Erweiterungsrichtlinie aufzurufen.

gcloud

Führen Sie den gcloud compute zone-vm-extension-policies list-Befehl aus, um alle projektbezogenen Erweiterungsrichtlinien in einer Zone aufzurufen:

gcloud compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
  • ZONE: der Name der Zone, in der Sie VM-Erweiterungsrichtlinien auflisten möchten.
  • PAGE_SIZE: die maximale Anzahl von Ergebnissen, die pro Seite zurückgegeben werden sollen.

Führen Sie den Befehl gcloud compute zone-vm-extension-policies describe aus, um Details zu einer bestimmten zonalen Erweiterungsrichtlinie auf Projektebene aufzurufen:

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

Ersetzen Sie Folgendes:

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

REST

Wenn Sie alle zonalen Erweiterungsrichtlinien in einem Projekt aufrufen möchten, senden Sie eine GET-Anfrage an die Methode zoneVmExtensionPolicies.list:

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

Wenn Sie Details zu einer bestimmten zonalen Erweiterungsrichtlinie in einem Projekt aufrufen möchten, senden Sie eine GET-Anfrage an die Methode zoneVmExtensionPolicies.get:

GET 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 aufrufen möchten.
  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
  • ZONE: die Google Cloud -Zone, in der sich die VM-Erweiterungsrichtlinie befindet.

VM-Erweiterungen und -Versionen ansehen

Mit den schreibgeschützten Methoden get und list können Sie die VM-Erweiterungen aufrufen, die VM Extension Manager in Ihrer Organisation, Ihrem Ordner oder Ihrem Projekt unterstützt. Sie können die Erweiterungsnamen, Versionsnummern und Erweiterungsunterstützungsstufen für alle Zonen oder innerhalb einer bestimmten Zone aufrufen.

VM-Erweiterungen in allen Zonen einer Organisation ansehen

Verwenden Sie die schreibgeschützten Methoden get und list, um die VM-Erweiterungen aufzurufen, die der VM Extension Manager in allen Zonen Ihrer Organisation unterstützt, einschließlich ihrer Versionsnummern und Supportstufen.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Organization Level Compute VM Extension Policies Viewer (roles/compute.orgVmExtensionPolicyViewer) oder Organization Level Compute VM Extension Policies Admin (roles/compute.orgVmExtensionPolicyAdmin) für Ihre Organisation zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von VM-Erweiterungen in Ihrer Organisation benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von VM-Erweiterungen in Ihrer Organisation erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um VM-Erweiterungen in Ihrer Organisation aufzurufen:

  • VM-Erweiterungen auflisten: compute.orgVmExtensions.list
  • Details einer VM-Erweiterung ansehen: compute.orgVmExtensions.get

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

Wählen Sie eine der folgenden Optionen aus, um die VM-Erweiterungen und -Versionen aufzurufen, die VM Extension Manager in allen Zonen Ihrer Organisation unterstützt:

gcloud

Wenn Sie alle VM-Erweiterungen, die von VM Extension Manager unterstützt werden, und ihre Supportstufen in allen Zonen Ihrer Organisation auflisten möchten, führen Sie den Befehl gcloud preview compute global-vm-extension-policies extensions list mit dem Flag --organization aus:

gcloud preview compute global-vm-extension-policies extensions list \
  --organization=organizations/ORGANIZATION_ID

Ersetzen Sie Folgendes:

  • ORGANIZATION_ID: die ID Ihrer Organisation in Google Cloud .

In der Ausgabe werden die vom VM Extension Manager unterstützten VM-Erweiterungen, ihre Versionen und ihre Erweiterungsunterstützungsstufen aufgeführt.

Führen Sie den Befehl gcloud preview compute global-vm-extension-policies extensions describe mit dem Flag --organization aus, um die Details einer bestimmten VM-Erweiterung in Ihrer Organisation aufzurufen:

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --organization=organizations/ORGANIZATION_ID

Ersetzen Sie Folgendes:

  • EXTENSION_NAME: der Name der VM-Erweiterung (z. B. ops-agent, google-cloud-sap-extension oder google-cloud-workload-extension).
  • ORGANIZATION_ID: die ID Ihrer Organisation in Google Cloud .

REST

Wenn Sie alle VM-Erweiterungen, die von VM Extension Manager unterstützt werden, und ihre Supportstufen in allen Zonen Ihrer Organisation auflisten möchten, senden Sie eine GET-Anfrage an die Methode organizationGlobalVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensions

Ersetzen Sie Folgendes:

  • ORGANIZATION_ID: die ID Ihrer Organisation in Google Cloud .

In der Antwort werden die vom VM Extension Manager unterstützten VM-Erweiterungen, ihre Versionen und ihre Erweiterungsunterstützungsstufen aufgeführt.

Wenn Sie die Details einer bestimmten VM-Erweiterung in Ihrer Organisation aufrufen möchten, senden Sie eine GET-Anfrage an die Methode organizationGlobalVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensions/EXTENSION_NAME

Ersetzen Sie Folgendes:

  • ORGANIZATION_ID: die ID Ihrer Organisation in Google Cloud .
  • EXTENSION_NAME: der Name der VM-Erweiterung (z. B. ops-agent).

VM-Erweiterungen in allen Zonen in einem Ordner ansehen

Verwenden Sie die schreibgeschützten Methoden get und list, um die VM-Erweiterungen aufzurufen, die der VM Extension Manager in allen Zonen in Ihrem Ordner unterstützt, einschließlich ihrer Versionsnummern und Supportstufen.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Folder level Compute VM extension policies viewer (roles/compute.folderVmExtensionPolicyViewer) oder Folder level Compute VM extension policies admin (roles/compute.folderVmExtensionPolicyAdmin) für Ihren Ordner zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von VM-Erweiterungen in Ihrem Ordner benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von VM-Erweiterungen in Ihrem Ordner erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um VM-Erweiterungen in Ihrem Ordner aufzurufen:

  • VM-Erweiterungen auflisten: compute.folderVmExtensions.list
  • Details einer VM-Erweiterung ansehen: compute.folderVmExtensions.get

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

Wählen Sie eine der folgenden Optionen aus, um die VM-Erweiterungen und -Versionen aufzurufen, die VM Extension Manager in allen Zonen in Ihrem Ordner unterstützt:

gcloud

Wenn Sie alle VM-Erweiterungen, die von VM Extension Manager unterstützt werden, und ihre Supportstufen in allen Zonen in Ihrem Ordner auflisten möchten, führen Sie den Befehl gcloud preview compute global-vm-extension-policies extensions list mit dem Flag --folder aus:

gcloud preview compute global-vm-extension-policies extensions list \
  --folder=folders/FOLDER_ID

Ersetzen Sie Folgendes:

  • FOLDER_ID: die ID Ihres Ordners in Google Cloud .

In der Ausgabe werden die vom VM Extension Manager unterstützten VM-Erweiterungen, ihre Versionen und ihre Erweiterungsunterstützungsstufen aufgeführt.

Führen Sie den Befehl gcloud preview compute global-vm-extension-policies extensions describe mit dem Flag --folder aus, um die Details einer bestimmten VM-Erweiterung in Ihrem Ordner aufzurufen:

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --folder=folders/FOLDER_ID

Ersetzen Sie Folgendes:

  • EXTENSION_NAME: der Name der VM-Erweiterung (z. B. ops-agent, google-cloud-sap-extension oder google-cloud-workload-extension).
  • FOLDER_ID: die ID Ihres Ordners in Google Cloud .

REST

Wenn Sie alle VM-Erweiterungen, die von VM Extension Manager unterstützt werden, und ihre Supportstufen in allen Zonen in Ihrem Ordner auflisten möchten, senden Sie eine GET-Anfrage an die Methode folderGlobalVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensions

Ersetzen Sie Folgendes:

  • FOLDER_ID: die ID Ihres Ordners in Google Cloud .

In der Antwort werden die vom VM Extension Manager unterstützten VM-Erweiterungen, ihre Versionen und ihre Erweiterungsunterstützungsstufen aufgeführt.

Wenn Sie die Details einer bestimmten VM-Erweiterung in Ihrem Ordner aufrufen möchten, senden Sie eine GET-Anfrage an die Methode folderGlobalVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensions/EXTENSION_NAME

Ersetzen Sie Folgendes:

  • FOLDER_ID: die ID Ihres Ordners in Google Cloud .
  • EXTENSION_NAME: der Name der VM-Erweiterung (z. B. ops-agent).

VM-Erweiterungen in allen Zonen eines Projekts ansehen

Verwenden Sie die schreibgeschützten Methoden get und list, um die VM-Erweiterungen aufzurufen, die der VM Extension Manager in allen Zonen Ihres Projekts unterstützt, einschließlich ihrer Versionsnummern und Supportstufen.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-VM-Erweiterungsrichtlinien-Betrachter (roles/compute.vmExtensionPolicyViewer) oder Compute-VM-Erweiterungsrichtlinien-Administrator (roles/compute.vmExtensionPolicyAdmin) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von VM-Erweiterungen in Ihrem Projekt benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von VM-Erweiterungen in Ihrem Projekt erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um VM-Erweiterungen in Ihrem Projekt anzusehen:

  • VM-Erweiterungen auflisten: compute.vmExtensions.list
  • Details einer VM-Erweiterung ansehen: compute.vmExtensions.get

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

Wählen Sie eine der folgenden Optionen aus, um die VM-Erweiterungen und -Versionen aufzurufen, die VM Extension Manager in allen Zonen Ihres Projekts unterstützt:

gcloud

Führen Sie den Befehl gcloud preview compute global-vm-extension-policies extensions list aus, um alle VM-Erweiterungen, die von VM Extension Manager unterstützt werden, und ihre Supportstufen in allen Zonen Ihres Projekts aufzulisten:

gcloud preview compute global-vm-extension-policies extensions list \
  --project=PROJECT_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .

In der Ausgabe werden die vom VM Extension Manager unterstützten VM-Erweiterungen, ihre Versionen und ihre Erweiterungsunterstützungsstufen aufgeführt.

Führen Sie den Befehl gcloud preview compute global-vm-extension-policies extensions describe aus, um die Details einer bestimmten VM-Erweiterung in Ihrem Projekt aufzurufen:

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID

Ersetzen Sie Folgendes:

  • EXTENSION_NAME: der Name der VM-Erweiterung (z. B. ops-agent, google-cloud-sap-extension oder google-cloud-workload-extension).
  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .

REST

Wenn Sie alle VM-Erweiterungen, die von VM Extension Manager unterstützt werden, und ihre Supportstufen in allen Zonen Ihres Projekts auflisten möchten, senden Sie eine GET-Anfrage an die Methode globalVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/global/vmExtensions

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .

Das folgende JSON-Snippet zeigt eine Beispielantwort, in der die vom VM Extension Manager unterstützten VM-Erweiterungen und ihre Erweiterungsunterstützungsstufen aufgeführt sind:

{
  "kind": "compute#globalVmExtensionList",
  "items": [
    {
      "kind": "compute#globalVmExtension",
      "name": "ops-agent",
      "versions": [
        "2.58.0",
        "2.57.0"
      ],
      "supportLevel": "GA",
      "selfLink": "https://www.googleapis.com/compute/2026-10-01-preview/projects/my-project/global/vmExtensions/ops-agent"
    }
  ]
}

Wenn Sie die Details einer bestimmten VM-Erweiterung in Ihrem Projekt aufrufen möchten, senden Sie eine GET-Anfrage an die Methode globalVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/global/vmExtensions/EXTENSION_NAME

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
  • EXTENSION_NAME: der Name der VM-Erweiterung (z. B. ops-agent).

VM-Erweiterungen in einer Zone in einer Organisation ansehen

Verwenden Sie die schreibgeschützten Methoden get und list, um die VM-Erweiterungen aufzurufen, die der VM Extension Manager in einer bestimmten Zone in Ihrer Organisation unterstützt, einschließlich ihrer Versionsnummern und Supportstufen.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Organization level Compute VM extension policies viewer (roles/compute.orgVmExtensionPolicyViewer) oder Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) für Ihre Organisation zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von VM-Erweiterungen in einer Zone in Ihrer Organisation benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von VM-Erweiterungen in einer Zone in Ihrer Organisation erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um VM-Erweiterungen in einer Zone in Ihrer Organisation aufzurufen:

  • VM-Erweiterungen auflisten: compute.orgVmExtensions.list
  • Details einer VM-Erweiterung ansehen: compute.orgVmExtensions.get

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

Wählen Sie eine der folgenden Optionen aus, um die VM-Erweiterungen und -Versionen aufzurufen, die VM Extension Manager in einer Zone in Ihrer Organisation unterstützt:

gcloud

Wenn Sie alle VM-Erweiterungen, die von VM Extension Manager unterstützt werden, und ihre Supportstufen in einer bestimmten Zone in Ihrer Organisation auflisten möchten, führen Sie den Befehl gcloud preview compute zone-vm-extension-policies extensions list mit dem Flag --organization aus:

gcloud preview compute zone-vm-extension-policies extensions list \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

Ersetzen Sie Folgendes:

  • ORGANIZATION_ID: die ID Ihrer Organisation in Google Cloud .
  • ZONE: die Google Cloud -Zone, in der Sie VM-Erweiterungen auflisten möchten (z. B. us-central1-a).

In der Ausgabe werden die vom VM Extension Manager unterstützten VM-Erweiterungen, ihre Versionen und ihre Erweiterungsunterstützungsstufen aufgeführt.

Führen Sie den Befehl gcloud preview compute zone-vm-extension-policies extensions describe mit dem Flag --organization aus, um die Details einer bestimmten VM-Erweiterung in einer Zone in Ihrer Organisation aufzurufen:

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

Ersetzen Sie Folgendes:

  • EXTENSION_NAME: der Name der VM-Erweiterung (z. B. ops-agent).
  • ORGANIZATION_ID: die ID Ihrer Organisation in Google Cloud .
  • ZONE: die Zone, in der Sie die Erweiterungsdetails aufrufen möchten.

REST

Wenn Sie alle VM-Erweiterungen, die von VM Extension Manager unterstützt werden, und ihre Supportstufen in einer bestimmten Zone in Ihrer Organisation auflisten möchten, senden Sie eine GET-Anfrage an die Methode organizationZoneVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensions

Ersetzen Sie Folgendes:

  • ORGANIZATION_ID: die ID Ihrer Organisation in Google Cloud .
  • ZONE: der Name der Zone (z. B. us-central1-a).

In der Antwort werden die vom VM Extension Manager unterstützten VM-Erweiterungen, ihre Versionen und ihre Erweiterungsunterstützungsstufen aufgeführt.

Wenn Sie die Details einer bestimmten VM-Erweiterung in einer Zone in Ihrer Organisation aufrufen möchten, senden Sie eine GET-Anfrage an die Methode organizationZoneVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

Ersetzen Sie Folgendes:

  • ORGANIZATION_ID: die ID Ihrer Organisation in Google Cloud .
  • ZONE: der Name der Zone.
  • EXTENSION_NAME: der Name der VM-Erweiterung.

VM-Erweiterungen in einer Zone in einem Ordner ansehen

Verwenden Sie die schreibgeschützten Methoden get und list, um die VM-Erweiterungen aufzurufen, die der VM Extension Manager in einer bestimmten Zone in Ihrem Ordner unterstützt, einschließlich ihrer Versionsnummern und Supportstufen.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Folder level Compute VM extension policies viewer (roles/compute.folderVmExtensionPolicyViewer) oder Folder level Compute VM extension policies admin (roles/compute.folderVmExtensionPolicyAdmin) für Ihren Ordner zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von VM-Erweiterungen in einer Zone in Ihrem Ordner benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von VM-Erweiterungen in einer Zone in Ihrem Ordner erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um VM-Erweiterungen in einer Zone in Ihrem Ordner aufzurufen:

  • VM-Erweiterungen auflisten: compute.folderVmExtensions.list
  • Details einer VM-Erweiterung ansehen: compute.folderVmExtensions.get

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

Wählen Sie eine der folgenden Optionen aus, um die VM-Erweiterungen und -Versionen aufzurufen, die VM Extension Manager in einer Zone in Ihrem Ordner unterstützt:

gcloud

Wenn Sie alle VM-Erweiterungen, die von VM Extension Manager unterstützt werden, und ihre Supportstufen in einer bestimmten Zone in Ihrem Ordner auflisten möchten, führen Sie den Befehl gcloud preview compute zone-vm-extension-policies extensions list mit dem Flag --folder aus:

gcloud preview compute zone-vm-extension-policies extensions list \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

Ersetzen Sie Folgendes:

  • FOLDER_ID: die ID Ihres Ordners in Google Cloud .
  • ZONE: die Google Cloud -Zone, in der Sie VM-Erweiterungen auflisten möchten (z. B. us-central1-a).

In der Ausgabe werden die vom VM Extension Manager unterstützten VM-Erweiterungen, ihre Versionen und ihre Erweiterungsunterstützungsstufen aufgeführt.

Führen Sie den Befehl gcloud preview compute zone-vm-extension-policies extensions describe mit dem Flag --folder aus, um die Details einer bestimmten VM-Erweiterung in einer Zone in Ihrem Ordner aufzurufen:

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

Ersetzen Sie Folgendes:

  • EXTENSION_NAME: der Name der VM-Erweiterung (z. B. ops-agent).
  • FOLDER_ID: die ID Ihres Ordners in Google Cloud .
  • ZONE: die Zone, in der Sie die Erweiterungsdetails aufrufen möchten.

REST

Wenn Sie alle VM-Erweiterungen, die von VM Extension Manager unterstützt werden, und ihre Supportstufen in einer bestimmten Zone in Ihrem Ordner auflisten möchten, senden Sie eine GET-Anfrage an die Methode folderZoneVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensions

Ersetzen Sie Folgendes:

  • FOLDER_ID: die ID Ihres Ordners in Google Cloud .
  • ZONE: der Name der Zone (z. B. us-central1-a).

In der Antwort werden die vom VM Extension Manager unterstützten VM-Erweiterungen, ihre Versionen und ihre Erweiterungsunterstützungsstufen aufgeführt.

Wenn Sie die Details einer bestimmten VM-Erweiterung in einer Zone in Ihrem Ordner aufrufen möchten, senden Sie eine GET-Anfrage an die Methode folderZoneVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

Ersetzen Sie Folgendes:

  • FOLDER_ID: die ID Ihres Ordners in Google Cloud .
  • ZONE: der Name der Zone.
  • EXTENSION_NAME: der Name der VM-Erweiterung.

VM-Erweiterungen in einer Zone in einem Projekt ansehen

Verwenden Sie die schreibgeschützten Methoden get und list, um die VM-Erweiterungen aufzurufen, die der VM Extension Manager in einer bestimmten Zone in Ihrem Projekt unterstützt, einschließlich ihrer Versionsnummern und Supportstufen.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-VM-Erweiterungsrichtlinien-Betrachter (roles/compute.vmExtensionPolicyViewer) oder Compute-VM-Erweiterungsrichtlinien-Administrator (roles/compute.vmExtensionPolicyAdmin) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von VM-Erweiterungen in einer Zone in Ihrem Projekt benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von VM-Erweiterungen in einer Zone in Ihrem Projekt erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um VM-Erweiterungen in einer Zone in Ihrem Projekt aufzurufen:

  • VM-Erweiterungen auflisten: compute.vmExtensions.list
  • Details einer VM-Erweiterung ansehen: compute.vmExtensions.get

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

Wählen Sie eine der folgenden Optionen aus, um die VM-Erweiterungen und -Versionen aufzurufen, die VM Extension Manager in einer Zone in Ihrem Projekt unterstützt:

gcloud

Führen Sie den gcloud preview compute zone-vm-extension-policies extensions list-Befehl aus, um alle VM-Erweiterungen, die von VM Extension Manager unterstützt werden, und ihre Supportstufen in einer bestimmten Zone in Ihrem Projekt aufzulisten:

gcloud preview compute zone-vm-extension-policies extensions list \
  --zone=ZONE \
  --project=PROJECT_ID

Ersetzen Sie Folgendes:

  • ZONE: die Google Cloud -Zone, in der Sie VM-Erweiterungen auflisten möchten (z. B. us-central1-a).
  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .

In der Ausgabe werden die vom VM Extension Manager unterstützten VM-Erweiterungen, ihre Versionen und ihre Erweiterungsunterstützungsstufen aufgeführt.

Führen Sie den Befehl gcloud preview compute zone-vm-extension-policies extensions describe aus, um die Details einer bestimmten VM-Erweiterung in einer Zone in Ihrem Projekt aufzurufen:

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --zone=ZONE \
  --project=PROJECT_ID

Ersetzen Sie Folgendes:

  • EXTENSION_NAME: der Name der VM-Erweiterung (z. B. ops-agent).
  • ZONE: die Zone, in der Sie die Erweiterungsdetails aufrufen möchten.
  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .

REST

Wenn Sie alle VM-Erweiterungen, die von VM Extension Manager unterstützt werden, und ihre Supportstufen in einer bestimmten Zone in Ihrem Projekt auflisten möchten, senden Sie eine GET-Anfrage an die Methode zoneVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/zones/ZONE/vmExtensions

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
  • ZONE: der Name der Zone (z. B. us-central1-a).

In der Antwort werden die vom VM Extension Manager unterstützten VM-Erweiterungen, ihre Versionen und ihre Erweiterungsunterstützungsstufen aufgeführt.

Wenn Sie die Details einer bestimmten VM-Erweiterung in einer Zone in Ihrem Projekt aufrufen möchten, senden Sie eine GET-Anfrage an die Methode zoneVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
  • ZONE: der Name der Zone.
  • EXTENSION_NAME: der Name der VM-Erweiterung.

VM-Erweiterungsstatus auf einer Instanz ansehen

Sie installieren VM-Erweiterungen auf VMs, indem Sie globale oder zonale Erweiterungsrichtlinien auf Organisations-, Ordner- oder Projektebene erstellen. Mit einer einzelnen Richtlinie können mehrere Erweiterungen auf einer einzelnen VM installiert werden. Außerdem können mehrere Richtlinien in Ihrer Ressourcenhierarchie auf dieselbe VM angewendet werden. Verwenden Sie die schreibgeschützten Methoden list und get für den Erweiterungsstatus der Instanz, um den Laufzeitstatus der installierten Erweiterungen auf jeder VM aufzurufen, ohne eine Verbindung zu einzelnen Maschinen herstellen zu müssen. Mit diesen Methoden können Sie die endgültige effektive Konfiguration und die geltende Richtlinie (policyId) für jede installierte Erweiterung aufrufen oder Fehler beheben, wenn eine unerwartete Erweiterung installiert wird oder eine Erweiterung auf einer Instanz fehlschlägt.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-Betrachter (roles/compute.viewer), Compute-Instanzadministrator (Version 1) (roles/compute.instanceAdmin.v1) oder Compute-Administrator (roles/compute.admin) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen der Status von VM-Erweiterungen auf einer Instanz benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von VM-Erweiterungsstatus auf einer Instanz erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um den Status von VM-Erweiterungen auf einer Instanz aufzurufen:

  • Alle VM-Erweiterungsstatus auf einer Instanz auflisten: compute.instances.listVmExtensionStates
  • Rufen Sie den Status einer bestimmten VM-Erweiterung auf einer Instanz ab: compute.instances.getVmExtensionState

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

Alle VM-Erweiterungsstatus auf einer Instanz auflisten

Wenn eine Richtlinie mehrere Erweiterungen auf einer VM installiert, wenn mehrere Richtlinien für dieselbe Instanz gelten oder wenn Sie bei der Fehlerbehebung eine unerwartete Erweiterung finden, listen Sie alle Erweiterungsstatus auf der VM auf, um die endgültige effektive Konfiguration und den Laufzeitstatus jeder installierten Erweiterung aufzurufen. In der Antwort werden die aktive Version, der Erzwingungsstatus, der Integritätsstatus und die geltende Richtlinie (policyId) der einzelnen Erweiterungen angezeigt.

Wählen Sie eine der folgenden Optionen aus, um den Status aller installierten VM-Erweiterungen auf einer Instanz aufzurufen:

gcloud

Führen Sie den gcloud beta compute instances list-vm-extension-states-Befehl aus, um alle installierten VM-Erweiterungen aufzulisten und ihren aktuellen Status auf einer Instanz aufzurufen:

gcloud beta compute instances list-vm-extension-states INSTANCE_NAME \
    --zone=ZONE \
    --project=PROJECT_ID

Ersetzen Sie die folgenden Variablen durch Werte für Ihre Umgebung:

  • INSTANCE_NAME ist der Name der VM-Instanz.
  • ZONE: die Zone, in der sich die Instanz befindet (z. B. us-central1-a).
  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .

Der Befehl gibt eine Tabelle zurück, in der der Name, der Erzwingungsstatus und der Zustand jeder installierten Erweiterung aufgeführt sind:

EXTENSION_NAME  ENFORCEMENT_STATE  HEALTH_STATUS
ops-agent       INSTALLED          RUNNING

REST

Wenn Sie alle installierten VM-Erweiterungen auflisten und ihren aktuellen Status auf einer Instanz aufrufen möchten, senden Sie eine GET-Anfrage an die Methode instances.listVmExtensionStates:

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/vmExtensionStates

Ersetzen Sie die folgenden Variablen durch Werte für Ihre Umgebung:

  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
  • ZONE: die Zone, in der sich die Instanz befindet.
  • INSTANCE_NAME: der Name oder die ID der VM-Instanz.

Das folgende JSON-Snippet zeigt eine Beispielantwort, in der die Status der installierten Erweiterungen auf einer Instanz aufgeführt sind:

{
  "kind": "compute#vmExtensionStatesList",
  "items": [
    {
      "name": "ops-agent",
      "version": "2.58.0",
      "healthStatus": "RUNNING",
      "enforcementState": "INSTALLED",
      "healthMsg": "Plugin is running ok",
      "policyId": "projects/my-project/zones/us-central1-a/vmExtensionPolicies/prod-ops-policy"
    }
  ]
}

Status einer bestimmten VM-Erweiterung auf einer Instanz aufrufen

Wenn mehrere Richtlinien auf eine VM abzielen oder eine installierte Erweiterung nicht wie erwartet ausgeführt wird, können Sie den Status dieser Erweiterung aufrufen, um die endgültige effektive Konfiguration (policyId und Version) und Diagnose-Statusmeldungen zu sehen.

Wählen Sie eine der folgenden Optionen aus, um den effektiven Status und die geltende Richtlinie einer bestimmten VM-Erweiterung auf einer Instanz aufzurufen:

gcloud

Führen Sie den gcloud beta compute instances get-vm-extension-state-Befehl aus, um den effektiven Status, die aktive Version und die geltende Richtlinie einer bestimmten VM-Erweiterung auf einer Instanz abzurufen:

gcloud beta compute instances get-vm-extension-state INSTANCE_NAME \
    --extension-name=EXTENSION_NAME \
    --zone=ZONE \
    --project=PROJECT_ID

Ersetzen Sie die folgenden Variablen durch Werte für Ihre Umgebung:

  • INSTANCE_NAME ist der Name der VM-Instanz.
  • EXTENSION_NAME: der Name der Erweiterung, die Sie prüfen möchten (z. B. ops-agent).
  • ZONE: die Zone, in der sich die Instanz befindet.
  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .

REST

Wenn Sie den effektiven Status, die aktive Version und die geltende Richtlinie einer bestimmten VM-Erweiterung auf einer Instanz abrufen möchten, senden Sie eine GET-Anfrage an die Methode instances.getVmExtensionState:

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/vmExtensionStates/EXTENSION_NAME

Ersetzen Sie die folgenden Variablen durch Werte für Ihre Umgebung:

  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .
  • ZONE: die Zone, in der sich die Instanz befindet.
  • INSTANCE_NAME: der Name oder die ID der VM-Instanz.
  • EXTENSION_NAME: der Name der VM-Erweiterung (z. B. ops-agent).

Das folgende JSON-Snippet zeigt eine Beispielantwort für den Status einer einzelnen VM-Erweiterung auf einer Instanz:

{
  "name": "ops-agent",
  "version": "2.58.0",
  "healthStatus": "RUNNING",
  "enforcementState": "INSTALLED",
  "enforcementMsg": "",
  "healthMsg": "Plugin is running ok",
  "policyId": "projects/my-project/zones/us-central1-a/vmExtensionPolicies/prod-ops-policy"
}

Statusfelder für VM-Erweiterungen interpretieren

Wenn Sie den Status einer VM-Erweiterung auf einer Instanz abrufen, enthält die Antwort Felder, die die erzwungene Richtlinie, die aktive Version, den Installationsfortschritt und den Laufzeitstatus des Plug-ins angeben.

In der folgenden Tabelle werden die Felder beschrieben, die von einer VmExtensionState-Ressource zurückgegeben werden:

Feld Beschreibung
name Die Kennung der VM-Erweiterung (z. B. ops-agent).
version Die aktive Version der Erweiterung, die auf der VM-Instanz installiert ist.
policyId Die Kennung der geltenden VM-Erweiterungsrichtlinie, die diese Erweiterung auf der Instanz erzwingt. Wenn mehrere Richtlinien auf die VM abzielen, gibt dieses Feld die Richtlinie an, die nach der Prioritätsauflösung angewendet wird.
enforcementState Der aktuelle Lebenszyklusstatus des Prozesses zur Durchsetzung der Erweiterung. Mögliche Werte:
  • ENFORCEMENT_STATE_UNSPECIFIED: Der Erzwingungsstatus ist nicht angegeben.
  • INSTALLING: Der Gast-Agent installiert die Erweiterung.
  • INSTALLED: Die Erweiterung ist auf der Instanz installiert.
  • INSTALL_FAILED: Die Installation ist fehlgeschlagen und es ist keine vorherige stabile Version für ein Rollback verfügbar.
  • ROLLING_BACK: Der Gast-Agent setzt die Erweiterung auf die letzte aufgezeichnete stabile Version zurück.
  • ROLLED_BACK: Die Erweiterung wurde auf die letzte stabile Version zurückgesetzt.
  • ROLLBACK_FAILED: Der Rollback-Versuch ist fehlgeschlagen.
  • INCOMPATIBLE: Keine der verfügbaren Versionen der Erweiterung ist mit dem Betriebssystem oder der Architektur der VM kompatibel.
  • REMOVING: Der Gast-Agent entfernt die Erweiterung aus der Instanz.
  • SERVICE_DISABLED: Die erforderliche Dienst-API für diese Erweiterung ist im Projekt deaktiviert.
  • APPLYING_CONFIG: Der Gast-Agent wendet eine neue Konfiguration auf die Erweiterung an. Dazu muss das Plug-in möglicherweise neu gestartet werden.
enforcementMsg Eine Diagnosestatusmeldung, die der Gast-Agent zurückgibt, wenn die Erweiterung nicht erzwungen werden kann oder ein Installationsfehler auftritt.
healthStatus Der Laufzeitstatus des erzwungenen Erweiterungs-Plug-ins. Wenn die Erweiterung noch nicht erzwungen wird, ist dieser Wert nicht angegeben. Mögliche Werte:
  • HEALTH_STATUS_UNSPECIFIED: Der Integritätsstatus ist nicht angegeben.
  • STARTING: Der Erweiterungsprozess wird gestartet.
  • RUNNING: Der Erweiterungsprozess wird normal ausgeführt.
  • STOPPING: Der Erweiterungsprozess wird beendet.
  • STOPPED: Der Erweiterungsprozess wird beendet.
  • CRASHED: Der Erweiterungsprozess wurde gestartet, aber unerwartet beendet.
healthMsg Eine Diagnosemeldung, die die Erweiterung zu ihrem Status meldet (z. B. Plugin is running ok).

Nächste Schritte

  • 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 Abfragen von historischen Erzwingungsereignissen und zum Prüfen von Installations- oder Absturzdatensätzen in Cloud Logging finden Sie unter VM-Erweiterungslogs ansehen.
  • 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 Ändern von Konfigurationseinstellungen, zum Ändern angepinnter Versionen oder zum Entfernen bereitgestellter Agents finden Sie unter VM-Erweiterungen mithilfe von Erweiterungsrichtlinien verwalten.