VM 拡張機能の詳細とステータスを表示する

Compute Engine 仮想マシン（VM）インスタンスに VM 拡張機能をインストールするには、組織、フォルダ、プロジェクト レベルでグローバルまたはゾーンの拡張機能ポリシーを作成します。1 つのポリシーで 1 つの VM に複数の拡張機能をインストールできます。また、複数のポリシーを同じ VM に適用できます。

このドキュメントでは、 Google Cloud リソース階層全体で読み取り専用の get メソッドと list メソッドを使用して、次のタスクを実行する方法について説明します。

  • リソース階層内の拡張機能ポリシーを表示する。グローバルまたはゾーンの VM 拡張機能ポリシーを一覧表示して、組織、フォルダ、プロジェクト全体のポリシーの詳細とロールアウト状態を表示します。
  • VM 拡張機能とバージョンを表示する。VM Extension Manager がサポートする VM 拡張機能を一覧表示するか、組織、フォルダ、プロジェクト内のすべてのゾーンまたは特定のゾーンで、バージョン番号やサポートレベルなどの拡張機能の詳細を表示します。
  • 各 VM にインストールされている拡張機能のステータスを表示する。ポリシーが VM に複数の拡張機能をインストールする場合は、インストールされているすべての VM 拡張機能と、インスタンスでのランタイム状態を一覧表示します。複数のポリシーが同じ VM に適用される場合は、最終的な有効な構成と管理ポリシー（policyId）を表示します。
  • インスタンスの拡張機能のトラブルシューティング。予期しない拡張機能がインストールされた場合や、VM インスタンスで拡張機能が失敗した場合に、インストールの進行状況、ランタイムのヘルス ステータス、診断メッセージを表示します。

始める前に

VM 拡張機能ポリシーの表示、VM 拡張機能の詳細の取得、VM インスタンスの拡張機能の状態の検査を行う前に、次の前提条件を満たしてください。

  • VM Extension Manager についてを読んで、拡張機能ポリシーが VM フリート全体でゲスト エージェント プラグインを管理する方法を理解する。
  • インスタンスに拡張機能をまだデプロイしていない場合は、まずポリシーを作成します。詳細については、拡張機能ポリシーを作成して VM 拡張機能をインストールするをご覧ください。
  • 拡張機能ポリシーの表示、拡張機能の詳細の取得、インスタンス拡張機能の状態の検査に必要な Identity and Access Management 権限があることを確認します。

ポリシーと拡張機能の表示に関する制限

VM 拡張機能ポリシー、拡張機能の詳細、インスタンスの状態を表示する際は、次の運用上の制約を考慮してください。

  • フォルダ スコープと組織スコープの VM 拡張機能ポリシーを表示するには、Google Cloud CLI または Compute Engine REST API を使用する必要があります。
  • VM 拡張機能の詳細とインスタンス拡張機能の状態を取得するには、Google Cloud CLI または Compute Engine REST API を使用する必要があります。Google Cloud コンソールで VM 拡張機能の詳細やインスタンスごとの拡張機能の状態を表示することはできません。
  • インスタンス拡張機能の状態 API（getVmExtensionState と listVmExtensionStates）は、VM Extension Manager ポリシーがインストールして管理する拡張機能のランタイム ステータスのみを報告します。これらの API は、VM Extension Manager の外部で手動でインストールしたスタンドアロン エージェントのステータスを報告しません。

拡張機能ポリシーを表示する

VM 拡張機能ポリシーを一覧表示したり、特定のポリシーの構成の詳細を組織、フォルダ、プロジェクト レベルで確認したりできます。

組織内のすべてのゾーンにわたるグローバル拡張機能ポリシーを表示する

組織内のすべてのグローバル VM 拡張機能ポリシーを一覧表示したり、特定の組織スコープのグローバル ポリシーを検査して、フリート全体の拡張機能のロールアウトを監査できます。

必要な IAM 権限

組織を対象とする拡張機能ポリシーを表示するために必要な権限を取得するには、組織に対する組織レベルの Compute VM 拡張機能ポリシー閲覧者（roles/compute.orgVmExtensionPolicyViewer）または組織レベルの Compute VM 拡張機能ポリシー管理者（roles/compute.orgVmExtensionPolicyAdmin）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

この事前定義ロールには、組織スコープの拡張機能ポリシーの表示に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

組織スコープの拡張機能ポリシーを表示するには、次の権限が必要です。

  • 拡張機能ポリシーを一覧表示する: compute.orgVmExtensionPolicies.list
  • 拡張機能ポリシーの詳細を表示する: compute.orgVmExtensionPolicies.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

組織内のグローバル拡張ポリシーを表示するには、次のいずれかのオプションを選択します。

gcloud

組織内のすべてのグローバル拡張機能ポリシーを表示するには、--organization フラグを指定して gcloud preview compute global-vm-extension-policies list コマンドを実行します。

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

次のように置き換えます。

  • ORGANIZATION_ID: Google Cloud 組織の ID。
  • PAGE_SIZE: ページごとに返す結果の最大数。

組織内の特定のグローバル拡張機能ポリシーの詳細を表示するには、--organization フラグを指定して gcloud preview compute global-vm-extension-policies describe コマンドを実行します。

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

次のように置き換えます。

  • POLICY_NAME: 表示する VM 拡張機能ポリシーの名前。
  • ORGANIZATION_ID: Google Cloud 組織の ID。

REST

組織内のすべてのグローバル拡張機能ポリシーを表示するには、organizationGlobalVmExtensionPolicies.list メソッドに GET リクエストを送信します。

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

組織内の特定のグローバル拡張機能ポリシーの詳細を表示するには、organizationGlobalVmExtensionPolicies.get メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • POLICY_NAME: 表示する VM 拡張機能ポリシーの名前。
  • ORGANIZATION_ID: Google Cloud 組織の ID。

フォルダ内のすべてのゾーンのグローバル拡張機能ポリシーを表示する

フォルダ内のすべてのグローバル VM 拡張機能ポリシーを一覧表示したり、特定のフォルダ スコープのグローバル ポリシーを検査して、そのフォルダ内のプロジェクトに適用される拡張機能を確認できます。

必要な IAM 権限

フォルダ スコープの拡張機能ポリシーを表示するために必要な権限を取得するには、フォルダに対するフォルダレベルの Compute VM 拡張機能ポリシー閲覧者（roles/compute.folderVmExtensionPolicyViewer）またはフォルダレベルの Compute VM 拡張機能ポリシー管理者（roles/compute.folderVmExtensionPolicyAdmin）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

この事前定義ロールには、フォルダ スコープの拡張機能ポリシーの表示に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

フォルダ スコープの拡張機能ポリシーを表示するには、次の権限が必要です。

  • 拡張機能ポリシーを一覧表示する: compute.folderVmExtensionPolicies.list
  • 拡張機能ポリシーの詳細を表示する: compute.folderVmExtensionPolicies.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

フォルダ内のグローバル拡張ポリシーを表示するには、次のいずれかのオプションを選択します。

gcloud

フォルダ内のすべてのグローバル拡張機能ポリシーを表示するには、--folder フラグを指定して gcloud preview compute global-vm-extension-policies list コマンドを実行します。

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

次のように置き換えます。

  • FOLDER_ID: Google Cloud フォルダの ID。
  • PAGE_SIZE: ページごとに返す結果の最大数。

フォルダ内の特定のグローバル拡張機能ポリシーの詳細を表示するには、--folder フラグを指定して gcloud preview compute global-vm-extension-policies describe コマンドを実行します。

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

次のように置き換えます。

  • POLICY_NAME: 表示する VM 拡張機能ポリシーの名前。
  • FOLDER_ID: Google Cloud フォルダの ID。

REST

フォルダ内のすべてのグローバル拡張機能ポリシーを表示するには、folderGlobalVmExtensionPolicies.list メソッドに GET リクエストを送信します。

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

フォルダ内の特定のグローバル拡張機能ポリシーの詳細を表示するには、folderGlobalVmExtensionPolicies.get メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • POLICY_NAME: 表示する VM 拡張機能ポリシーの名前。
  • FOLDER_ID: Google Cloud フォルダの ID。

プロジェクト内のすべてのゾーンにわたるグローバル拡張機能ポリシーを表示する

プロジェクト内のグローバル VM 拡張機能ポリシーを表示して、ロールアウトの進行状況をモニタリングし、そのプロジェクト内のすべてのゾーンで拡張機能の構成を検査できます。

必要な IAM 権限

プロジェクト スコープの拡張機能ポリシーを表示するために必要な権限を取得するには、プロジェクトに対する Compute VM 拡張機能ポリシー閲覧者（roles/compute.vmExtensionPolicyViewer）または Compute VM 拡張機能ポリシー管理者（roles/compute.vmExtensionPolicyAdmin）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

この事前定義ロールには、プロジェクト スコープの拡張機能ポリシーの表示に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

プロジェクト スコープの拡張機能ポリシーを表示するには、次の権限が必要です。

  • 拡張機能ポリシーを一覧表示する: compute.vmExtensionPolicies.list
  • 拡張機能ポリシーの詳細を表示する: compute.vmExtensionPolicies.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

プロジェクト内のグローバル拡張機能ポリシーを表示するには、次のいずれかのオプションを選択します。

コンソール

Google Cloud コンソールを使用してプロジェクトのグローバル VM 拡張機能ポリシーを表示するには、次の操作を行います。

  1. Google Cloud コンソールで、[VM 拡張機能ポリシー] ページに移動します。

    [VM 拡張機能ポリシー] に移動

  2. [グローバル ポリシー] をクリックします。このタブには、プロジェクト内のすべてのグローバル VM 拡張機能ポリシーが一覧表示されます。

gcloud

プロジェクト内のすべてのグローバル拡張機能ポリシーを表示するには、gcloud compute global-vm-extension-policies list コマンドを実行します。

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

次のように置き換えます。

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • PAGE_SIZE: ページごとに返す結果の最大数。

プロジェクト内の特定のグローバル拡張機能ポリシーの詳細を表示するには、gcloud compute global-vm-extension-policies describe コマンドを実行します。

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

次のように置き換えます。

  • POLICY_NAME: 表示する VM 拡張機能ポリシーの名前。
  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。

REST

プロジェクト内のすべてのグローバル拡張機能ポリシーを表示するには、globalVmExtensionPolicies.list メソッドに GET リクエストを送信します。

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

プロジェクト内の特定のグローバル拡張機能ポリシーの詳細を表示するには、globalVmExtensionPolicies.get メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • POLICY_NAME: 表示する VM 拡張機能ポリシーの名前。
  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。

組織全体のゾーン内のゾーン拡張機能ポリシーを表示する

特定のゾーンで組織を対象とする VM 拡張機能ポリシーを一覧表示したり、単一のポリシーを検査して、組織全体でゾーンレベルの適用ルールを監査したりできます。

必要な IAM 権限

組織を対象とする拡張機能ポリシーを表示するために必要な権限を取得するには、組織に対する組織レベルの Compute VM 拡張機能ポリシー閲覧者（roles/compute.orgVmExtensionPolicyViewer）または組織レベルの Compute VM 拡張機能ポリシー管理者（roles/compute.orgVmExtensionPolicyAdmin）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

この事前定義ロールには、組織スコープの拡張機能ポリシーの表示に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

組織スコープの拡張機能ポリシーを表示するには、次の権限が必要です。

  • 拡張機能ポリシーを一覧表示する: compute.orgVmExtensionPolicies.list
  • 拡張機能ポリシーの詳細を表示する: compute.orgVmExtensionPolicies.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

組織内のゾーン拡張ポリシーを表示するには、次のいずれかのオプションを選択します。

gcloud

ゾーン内のすべての組織スコープの拡張機能ポリシーを表示するには、--organization フラグを指定して gcloud preview compute zone-vm-extension-policies list コマンドを実行します。

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

次のように置き換えます。

  • ORGANIZATION_ID: Google Cloud 組織の ID。
  • ZONE: VM 拡張機能ポリシーを一覧表示するゾーンの名前。
  • PAGE_SIZE: ページごとに返す結果の最大数。

特定の組織スコープのゾーン拡張ポリシーの詳細を表示するには、--organization フラグを指定して gcloud preview compute zone-vm-extension-policies describe コマンドを実行します。

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

次のように置き換えます。

  • POLICY_NAME: 表示する VM 拡張機能ポリシーの名前。
  • ORGANIZATION_ID: Google Cloud 組織の ID。
  • ZONE: VM 拡張機能ポリシーが配置されている Google Cloud ゾーン。

REST

組織内のすべてのゾーン拡張機能ポリシーを表示するには、organizationZoneVmExtensionPolicies.list メソッドに GET リクエストを送信します。

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

組織内の特定のゾーン拡張機能ポリシーの詳細を表示するには、organizationZoneVmExtensionPolicies.get メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • POLICY_NAME: 表示する VM 拡張機能ポリシーの名前。
  • ORGANIZATION_ID: Google Cloud 組織の ID。
  • ZONE: VM 拡張機能ポリシーが配置されている Google Cloud ゾーン。

フォルダ全体のゾーン内のゾーン拡張機能ポリシーを表示する

特定のゾーン内のフォルダ スコープの VM 拡張機能ポリシーを一覧表示したり、単一のポリシーを検査して、フォルダ内のプロジェクトのゾーンレベルの拡張機能ルールを確認できます。

必要な IAM 権限

フォルダ スコープの拡張機能ポリシーを表示するために必要な権限を取得するには、フォルダに対するフォルダレベルの Compute VM 拡張機能ポリシー閲覧者（roles/compute.folderVmExtensionPolicyViewer）またはフォルダレベルの Compute VM 拡張機能ポリシー管理者（roles/compute.folderVmExtensionPolicyAdmin）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

この事前定義ロールには、フォルダ スコープの拡張機能ポリシーの表示に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

フォルダ スコープの拡張機能ポリシーを表示するには、次の権限が必要です。

  • 拡張機能ポリシーを一覧表示する: compute.folderVmExtensionPolicies.list
  • 拡張機能ポリシーの詳細を表示する: compute.folderVmExtensionPolicies.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

フォルダ内のゾーン拡張ポリシーを表示するには、次のいずれかのオプションを選択します。

gcloud

ゾーン内のすべてのフォルダ スコープの拡張機能ポリシーを表示するには、--folder フラグを指定して gcloud preview compute zone-vm-extension-policies list コマンドを実行します。

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

次のように置き換えます。

  • FOLDER_ID: Google Cloud フォルダの ID。
  • ZONE: VM 拡張機能ポリシーを一覧表示するゾーンの名前。
  • PAGE_SIZE: ページごとに返す結果の最大数。

特定のフォルダ スコープのゾーン拡張ポリシーの詳細を表示するには、--folder フラグを指定して gcloud preview compute zone-vm-extension-policies describe コマンドを実行します。

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

次のように置き換えます。

  • POLICY_NAME: 表示する VM 拡張機能ポリシーの名前。
  • FOLDER_ID: Google Cloud フォルダの ID。
  • ZONE: VM 拡張機能ポリシーが配置されている Google Cloud ゾーン。

REST

フォルダ内のすべてのゾーン拡張機能ポリシーを表示するには、folderZoneVmExtensionPolicies.list メソッドに GET リクエストを送信します。

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

フォルダ内の特定のゾーン拡張機能ポリシーの詳細を表示するには、folderZoneVmExtensionPolicies.get メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • POLICY_NAME: 表示する VM 拡張機能ポリシーの名前。
  • FOLDER_ID: Google Cloud フォルダの ID。
  • ZONE: VM 拡張機能ポリシーが配置されている Google Cloud ゾーン。

プロジェクトのゾーン内のゾーン拡張機能ポリシーを表示する

特定のゾーン内のプロジェクト スコープの VM 拡張機能ポリシーを一覧表示したり、単一のポリシーを検査して、そのゾーンのインスタンスに適用される拡張機能を確認したりできます。

必要な IAM 権限

プロジェクト スコープの拡張機能ポリシーを表示するために必要な権限を取得するには、プロジェクトに対する Compute VM 拡張機能ポリシー閲覧者（roles/compute.vmExtensionPolicyViewer）または Compute VM 拡張機能ポリシー管理者（roles/compute.vmExtensionPolicyAdmin）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

この事前定義ロールには、プロジェクト スコープの拡張機能ポリシーの表示に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

プロジェクト スコープの拡張機能ポリシーを表示するには、次の権限が必要です。

  • 拡張機能ポリシーを一覧表示する: compute.vmExtensionPolicies.list
  • 拡張機能ポリシーの詳細を表示する: compute.vmExtensionPolicies.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

プロジェクト内のゾーン拡張機能ポリシーを表示するには、次のいずれかのオプションを選択します。

コンソール

Google Cloud コンソールを使用してプロジェクトのゾーン VM 拡張機能ポリシーを表示するには、次の操作を行います。

  1. Google Cloud コンソールで、[VM 拡張機能ポリシー] ページに移動します。

    [VM 拡張機能ポリシー] に移動

  2. 特定の拡張機能ポリシーの詳細を表示するには、ポリシーの名前をクリックします。

gcloud

ゾーン内のすべてのプロジェクト スコープの拡張機能ポリシーを表示するには、gcloud compute zone-vm-extension-policies list コマンドを実行します。

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

次のように置き換えます。

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • ZONE: VM 拡張機能ポリシーを一覧表示するゾーンの名前。
  • PAGE_SIZE: ページごとに返す結果の最大数。

特定のプロジェクト スコープのゾーン拡張機能ポリシーの詳細を表示するには、gcloud compute zone-vm-extension-policies describe コマンドを実行します。

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

次のように置き換えます。

  • POLICY_NAME: 表示する VM 拡張機能ポリシーの名前。
  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • ZONE: VM 拡張機能ポリシーが配置されている Google Cloud ゾーン。

REST

プロジェクト内のすべてのゾーン拡張機能ポリシーを表示するには、zoneVmExtensionPolicies.list メソッドに GET リクエストを送信します。

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

プロジェクト内の特定のゾーン拡張機能ポリシーの詳細を表示するには、zoneVmExtensionPolicies.get メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • POLICY_NAME: 表示する VM 拡張機能ポリシーの名前。
  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • ZONE: VM 拡張機能ポリシーが配置されている Google Cloud ゾーン。

VM 拡張機能とバージョンを表示する

読み取り専用の get メソッドと list メソッドを使用すると、VM Extension Manager が組織、フォルダ、プロジェクト全体でサポートしている VM 拡張機能を表示できます。拡張機能の名前、バージョン番号、拡張機能のサポートレベルは、すべてのゾーンまたは特定のゾーン内で表示できます。

組織内のすべてのゾーンの VM 拡張機能を表示する

読み取り専用の get メソッドと list メソッドを使用して、VM Extension Manager が組織内のすべてのゾーンでサポートしている VM 拡張機能（バージョン番号とサポートレベルを含む）を表示します。

必要な IAM 権限

組織全体の VM 拡張機能を表示するために必要な権限を取得するには、組織に対する組織レベルの Compute VM 拡張機能ポリシー閲覧者（roles/compute.orgVmExtensionPolicyViewer）または組織レベルの Compute VM 拡張機能ポリシー管理者（roles/compute.orgVmExtensionPolicyAdmin）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

この事前定義ロールには、組織全体で VM 拡張機能を表示するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

組織全体の VM 拡張機能を表示するには、次の権限が必要です。

  • VM 拡張機能を一覧表示する: compute.orgVmExtensions.list
  • VM 拡張機能の詳細を表示する: compute.orgVmExtensions.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

VM Extension Manager が組織内のすべてのゾーンでサポートしている VM 拡張機能とバージョンを表示するには、次のいずれかのオプションを選択します。

gcloud

VM Extension Manager がサポートするすべての VM 拡張機能と、組織内のすべてのゾーンでのサポートレベルを一覧表示するには、--organization フラグを指定して gcloud preview compute global-vm-extension-policies extensions list コマンドを実行します。

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

次のように置き換えます。

  • ORGANIZATION_ID: Google Cloud 組織の ID。

出力には、VM Extension Manager がサポートする VM 拡張機能、そのバージョン、拡張機能のサポートレベルが一覧表示されます。

組織内の特定の VM 拡張機能の詳細を表示するには、--organization フラグを指定して gcloud preview compute global-vm-extension-policies extensions describe コマンドを実行します。

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

次のように置き換えます。

  • EXTENSION_NAME: VM 拡張機能の名前（例: ops-agent、google-cloud-sap-extension、google-cloud-workload-extension）。
  • ORGANIZATION_ID: Google Cloud 組織の ID。

REST

VM Extension Manager がサポートするすべての VM 拡張機能と、組織内のすべてのゾーンでのサポートレベルを一覧表示するには、organizationGlobalVmExtensionPolicies.listVmExtensions メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • ORGANIZATION_ID: Google Cloud 組織の ID。

レスポンスには、VM Extension Manager がサポートする VM 拡張機能、そのバージョン、拡張機能のサポートレベルが一覧表示されます。

組織内の特定の VM 拡張機能の詳細を表示するには、organizationGlobalVmExtensionPolicies.getVmExtension メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • ORGANIZATION_ID: Google Cloud 組織の ID。
  • EXTENSION_NAME: VM 拡張機能の名前（例: ops-agent）。

フォルダ内のすべてのゾーンの VM 拡張機能を表示する

読み取り専用の get メソッドと list メソッドを使用して、VM Extension Manager がフォルダ内のすべてのゾーンでサポートしている VM 拡張機能（バージョン番号とサポートレベルを含む）を表示します。

必要な IAM 権限

フォルダ全体の VM 拡張機能を表示するために必要な権限を取得するには、フォルダに対するフォルダレベルの Compute VM 拡張機能ポリシー閲覧者（roles/compute.folderVmExtensionPolicyViewer）またはフォルダレベルの Compute VM 拡張機能ポリシー管理者（roles/compute.folderVmExtensionPolicyAdmin）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

この事前定義ロールには、フォルダ全体で VM 拡張機能を表示するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

フォルダ全体の VM 拡張機能を表示するには、次の権限が必要です。

  • VM 拡張機能を一覧表示する: compute.folderVmExtensions.list
  • VM 拡張機能の詳細を表示する: compute.folderVmExtensions.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

フォルダ内のすべてのゾーンで VM Extension Manager がサポートする VM 拡張機能とバージョンを表示するには、次のいずれかのオプションを選択します。

gcloud

VM Extension Manager がサポートするすべての VM 拡張機能と、フォルダ内のすべてのゾーンでのサポートレベルを一覧表示するには、--folder フラグを指定して gcloud preview compute global-vm-extension-policies extensions list コマンドを実行します。

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

次のように置き換えます。

  • FOLDER_ID: Google Cloud フォルダの ID。

出力には、VM Extension Manager がサポートする VM 拡張機能、そのバージョン、拡張機能のサポートレベルが一覧表示されます。

フォルダ内の特定の VM 拡張機能の詳細を表示するには、--folder フラグを指定して gcloud preview compute global-vm-extension-policies extensions describe コマンドを実行します。

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

次のように置き換えます。

  • EXTENSION_NAME: VM 拡張機能の名前（例: ops-agent、google-cloud-sap-extension、google-cloud-workload-extension）。
  • FOLDER_ID: Google Cloud フォルダの ID。

REST

VM Extension Manager がサポートするすべての VM 拡張機能と、フォルダ内のすべてのゾーンでのサポートレベルを一覧表示するには、folderGlobalVmExtensionPolicies.listVmExtensions メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • FOLDER_ID: Google Cloud フォルダの ID。

レスポンスには、VM Extension Manager がサポートする VM 拡張機能、そのバージョン、拡張機能のサポートレベルが一覧表示されます。

フォルダ内の特定の VM 拡張機能の詳細を表示するには、folderGlobalVmExtensionPolicies.getVmExtension メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • FOLDER_ID: Google Cloud フォルダの ID。
  • EXTENSION_NAME: VM 拡張機能の名前（例: ops-agent）。

プロジェクト内のすべてのゾーンの VM 拡張機能を表示する

読み取り専用の get メソッドと list メソッドを使用して、VM Extension Manager がプロジェクト内のすべてのゾーンでサポートしている VM 拡張機能（バージョン番号とサポートレベルを含む）を表示します。

必要な IAM 権限

プロジェクト内の VM 拡張機能を表示するために必要な権限を取得するには、プロジェクトに対する Compute VM 拡張機能ポリシー閲覧者（roles/compute.vmExtensionPolicyViewer）または Compute VM 拡張機能ポリシー管理者（roles/compute.vmExtensionPolicyAdmin）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

この事前定義ロールには、プロジェクトで VM 拡張機能を表示するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

プロジェクトで VM 拡張機能を表示するには、次の権限が必要です。

  • VM 拡張機能を一覧表示する: compute.vmExtensions.list
  • VM 拡張機能の詳細を表示する: compute.vmExtensions.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

プロジェクトのすべてのゾーンで VM Extension Manager がサポートする VM 拡張機能とバージョンを表示するには、次のいずれかのオプションを選択します。

gcloud

VM Extension Manager がサポートするすべての VM 拡張機能と、プロジェクト内のすべてのゾーンでのサポートレベルを一覧表示するには、gcloud preview compute global-vm-extension-policies extensions list コマンドを実行します。

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

次のように置き換えます。

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。

出力には、VM Extension Manager がサポートする VM 拡張機能、そのバージョン、拡張機能のサポートレベルが一覧表示されます。

プロジェクト内の特定の VM 拡張機能の詳細を表示するには、gcloud preview compute global-vm-extension-policies extensions describe コマンドを実行します。

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

次のように置き換えます。

  • EXTENSION_NAME: VM 拡張機能の名前（例: ops-agent、google-cloud-sap-extension、google-cloud-workload-extension）。
  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。

REST

VM Extension Manager がサポートするすべての VM 拡張機能と、プロジェクト内のすべてのゾーンにおけるサポートレベルを一覧表示するには、globalVmExtensionPolicies.listVmExtensions メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。

次の JSON スニペットは、VM Extension Manager がサポートする VM 拡張機能とその拡張機能のサポートレベルを一覧表示するレスポンスの例を示しています。

{
  "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"
    }
  ]
}

プロジェクト内の特定の VM 拡張機能の詳細を表示するには、globalVmExtensionPolicies.getVmExtension メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • EXTENSION_NAME: VM 拡張機能の名前（例: ops-agent）。

組織内のゾーンの VM 拡張機能を表示する

読み取り専用の get メソッドと list メソッドを使用して、VM Extension Manager が組織全体の特定のゾーンでサポートしている VM 拡張機能（バージョン番号とサポートレベルを含む）を表示します。

必要な IAM 権限

組織全体のゾーン内の VM 拡張機能を表示するために必要な権限を取得するには、組織に対する組織レベルの Compute VM 拡張機能ポリシー閲覧者（roles/compute.orgVmExtensionPolicyViewer）または組織レベルの Compute VM 拡張機能ポリシー管理者（roles/compute.orgVmExtensionPolicyAdmin）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

この事前定義ロールには、組織全体のゾーン内の VM 拡張機能を表示するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

組織全体のゾーン内の VM 拡張機能を表示するには、次の権限が必要です。

  • VM 拡張機能を一覧表示する: compute.orgVmExtensions.list
  • VM 拡張機能の詳細を表示する: compute.orgVmExtensions.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

組織全体のゾーンで VM Extension Manager がサポートする VM 拡張機能とバージョンを表示するには、次のいずれかのオプションを選択します。

gcloud

VM Extension Manager がサポートするすべての VM 拡張機能と、組織全体の特定のゾーンでのサポートレベルを一覧表示するには、--organization フラグを指定して gcloud preview compute zone-vm-extension-policies extensions list コマンドを実行します。

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

次のように置き換えます。

  • ORGANIZATION_ID: Google Cloud 組織の ID。
  • ZONE: VM 拡張機能を一覧表示する Google Cloud ゾーン（例: us-central1-a）。

出力には、VM Extension Manager がサポートする VM 拡張機能、そのバージョン、拡張機能のサポートレベルが一覧表示されます。

組織全体のゾーン内の特定の VM 拡張機能の詳細を表示するには、--organization フラグを指定して gcloud preview compute zone-vm-extension-policies extensions describe コマンドを実行します。

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

次のように置き換えます。

  • EXTENSION_NAME: VM 拡張機能の名前（例: ops-agent）。
  • ORGANIZATION_ID: Google Cloud 組織の ID。
  • ZONE: 拡張機能の詳細を表示するゾーン。

REST

VM Extension Manager がサポートするすべての VM 拡張機能と、組織全体の特定のゾーンでのサポートレベルを一覧表示するには、organizationZoneVmExtensionPolicies.listVmExtensions メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • ORGANIZATION_ID: Google Cloud 組織の ID。
  • ZONE: ゾーンの名前（例: us-central1-a）。

レスポンスには、VM Extension Manager がサポートする VM 拡張機能、そのバージョン、拡張機能のサポートレベルが一覧表示されます。

組織全体のゾーンにある特定の VM 拡張機能の詳細を表示するには、organizationZoneVmExtensionPolicies.getVmExtension メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • ORGANIZATION_ID: Google Cloud 組織の ID。
  • ZONE: ゾーンの名前。
  • EXTENSION_NAME: VM 拡張機能の名前。

フォルダ内のゾーンの VM 拡張機能を表示する

読み取り専用の get メソッドと list メソッドを使用して、VM Extension Manager がフォルダ内の特定のゾーンでサポートしている VM 拡張機能（バージョン番号とサポートレベルを含む）を表示します。

必要な IAM 権限

フォルダ内のゾーンで VM 拡張機能を表示するために必要な権限を取得するには、フォルダに対するフォルダレベルの Compute VM 拡張機能ポリシー閲覧者（roles/compute.folderVmExtensionPolicyViewer）またはフォルダレベルの Compute VM 拡張機能ポリシー管理者（roles/compute.folderVmExtensionPolicyAdmin）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

この事前定義ロールには、フォルダ内のゾーンで VM 拡張機能を表示するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

フォルダ内のゾーンで VM 拡張機能を表示するには、次の権限が必要です。

  • VM 拡張機能を一覧表示する: compute.folderVmExtensions.list
  • VM 拡張機能の詳細を表示する: compute.folderVmExtensions.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

フォルダ内のゾーンで VM Extension Manager がサポートする VM 拡張機能とバージョンを表示するには、次のいずれかのオプションを選択します。

gcloud

VM Extension Manager がサポートするすべての VM 拡張機能と、フォルダ全体の特定のゾーンでのサポートレベルを一覧表示するには、--folder フラグを指定して gcloud preview compute zone-vm-extension-policies extensions list コマンドを実行します。

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

次のように置き換えます。

  • FOLDER_ID: Google Cloud フォルダの ID。
  • ZONE: VM 拡張機能を一覧表示する Google Cloud ゾーン（例: us-central1-a）。

出力には、VM Extension Manager がサポートする VM 拡張機能、そのバージョン、拡張機能のサポートレベルが一覧表示されます。

フォルダ内のゾーンにある特定の VM 拡張機能の詳細を表示するには、--folder フラグを指定して gcloud preview compute zone-vm-extension-policies extensions describe コマンドを実行します。

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

次のように置き換えます。

  • EXTENSION_NAME: VM 拡張機能の名前（例: ops-agent）。
  • FOLDER_ID: Google Cloud フォルダの ID。
  • ZONE: 拡張機能の詳細を表示するゾーン。

REST

VM Extension Manager がサポートするすべての VM 拡張機能と、フォルダ全体の特定のゾーンでのサポートレベルを一覧表示するには、folderZoneVmExtensionPolicies.listVmExtensions メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • FOLDER_ID: Google Cloud フォルダの ID。
  • ZONE: ゾーンの名前（例: us-central1-a）。

レスポンスには、VM Extension Manager がサポートする VM 拡張機能、そのバージョン、拡張機能のサポートレベルが一覧表示されます。

フォルダ内のゾーンにある特定の VM 拡張機能の詳細を表示するには、folderZoneVmExtensionPolicies.getVmExtension メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • FOLDER_ID: Google Cloud フォルダの ID。
  • ZONE: ゾーンの名前。
  • EXTENSION_NAME: VM 拡張機能の名前。

プロジェクトのゾーン内の VM 拡張機能を表示する

読み取り専用の get メソッドと list メソッドを使用して、プロジェクトの特定のゾーンで VM Extension Manager がサポートする VM 拡張機能（バージョン番号とサポートレベルを含む）を表示します。

必要な IAM 権限

プロジェクトのゾーン内の VM 拡張機能を表示するために必要な権限を取得するには、プロジェクトに対する Compute VM 拡張機能ポリシー閲覧者（roles/compute.vmExtensionPolicyViewer）または Compute VM 拡張機能ポリシー管理者（roles/compute.vmExtensionPolicyAdmin）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

この事前定義ロールには、プロジェクトのゾーン内の VM 拡張機能を表示するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

プロジェクトのゾーン内の VM 拡張機能を表示するには、次の権限が必要です。

  • VM 拡張機能を一覧表示する: compute.vmExtensions.list
  • VM 拡張機能の詳細を表示する: compute.vmExtensions.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

プロジェクトのゾーンで VM Extension Manager がサポートする VM 拡張機能とバージョンを表示するには、次のいずれかのオプションを選択します。

gcloud

VM Extension Manager がサポートするすべての VM 拡張機能と、プロジェクトの特定のゾーンでのサポートレベルを一覧表示するには、gcloud preview compute zone-vm-extension-policies extensions list コマンドを実行します。

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

次のように置き換えます。

  • ZONE: VM 拡張機能を一覧表示する Google Cloud ゾーン（例: us-central1-a）。
  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。

出力には、VM Extension Manager がサポートする VM 拡張機能、そのバージョン、拡張機能のサポートレベルが一覧表示されます。

プロジェクトのゾーン内の特定の VM 拡張機能の詳細を表示するには、gcloud preview compute zone-vm-extension-policies extensions describe コマンドを実行します。

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

次のように置き換えます。

  • EXTENSION_NAME: VM 拡張機能の名前（例: ops-agent）。
  • ZONE: 拡張機能の詳細を表示するゾーン。
  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。

REST

VM Extension Manager がサポートするすべての VM 拡張機能と、プロジェクトの特定のゾーンでのサポートレベルを一覧表示するには、zoneVmExtensionPolicies.listVmExtensions メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • ZONE: ゾーンの名前（例: us-central1-a）。

レスポンスには、VM Extension Manager がサポートする VM 拡張機能、そのバージョン、拡張機能のサポートレベルが一覧表示されます。

プロジェクトのゾーン内の特定の VM 拡張機能の詳細を表示するには、zoneVmExtensionPolicies.getVmExtension メソッドに GET リクエストを送信します。

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

次のように置き換えます。

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • ZONE: ゾーンの名前。
  • EXTENSION_NAME: VM 拡張機能の名前。

インスタンスの VM 拡張機能の状態を表示する

VM 拡張機能を VM にインストールするには、組織、フォルダ、プロジェクトのいずれかのレベルでグローバルまたはゾーンの拡張機能ポリシーを作成します。1 つのポリシーで 1 つの VM に複数の拡張機能をインストールできます。また、リソース階層全体で複数のポリシーを同じ VM に適用できます。読み取り専用のインスタンス拡張機能の状態 list メソッドと get メソッドを使用すると、個々のマシンに接続することなく、各 VM にインストールされている拡張機能のランタイム ステータスを表示できます。これらのメソッドを使用すると、インストールされている各拡張機能の最終的な有効な構成と管理ポリシー（policyId）を確認できます。また、予期しない拡張機能がインストールされた場合や、インスタンスで拡張機能が失敗した場合のトラブルシューティングにも役立ちます。

必要な IAM 権限

インスタンスで VM 拡張機能の状態を表示するために必要な権限を取得するには、プロジェクトに対する Compute 閲覧者（roles/compute.viewer）、Compute インスタンス管理者（v1）（roles/compute.instanceAdmin.v1）、または Compute 管理者（roles/compute.admin）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

この事前定義ロールには、インスタンスの VM 拡張機能の状態を表示するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

インスタンスの VM 拡張機能の状態を表示するには、次の権限が必要です。

  • インスタンスのすべての VM 拡張機能の状態を一覧表示する: compute.instances.listVmExtensionStates
  • インスタンス上の特定の VM 拡張機能の状態を取得する: compute.instances.getVmExtensionState

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

インスタンスのすべての VM 拡張機能の状態を一覧表示する

ポリシーによって VM に複数の拡張機能がインストールされている場合、同じインスタンスに複数のポリシーが適用されている場合、トラブルシューティング中に予期しない拡張機能が見つかった場合は、VM 上のすべての拡張機能の状態を一覧表示して、インストールされているすべての拡張機能の最終的な有効な構成とランタイム ステータスを確認します。レスポンスには、各拡張機能のアクティブなバージョン、適用状態、ヘルス ステータス、管理ポリシー（policyId）が表示されます。

インスタンスにインストールされているすべての VM 拡張機能の状態を表示するには、次のいずれかのオプションを選択します。

gcloud

インストールされているすべての VM 拡張機能を一覧表示し、インスタンスでの現在の状態を表示するには、gcloud beta compute instances list-vm-extension-states コマンドを実行します。

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

次の変数を、実際の環境の値に置き換えます。

  • INSTANCE_NAME: VM インスタンスの名前。
  • ZONE: インスタンスが配置されているゾーン（例: us-central1-a）。
  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。

このコマンドは、インストールされている各拡張機能の名前、適用状態、ヘルス ステータスを一覧表示するテーブルを返します。

EXTENSION_NAME  ENFORCEMENT_STATE  HEALTH_STATUS
ops-agent       INSTALLED          RUNNING

REST

インストールされているすべての VM 拡張機能を一覧表示し、インスタンスの現在の状態を表示するには、instances.listVmExtensionStates メソッドに GET リクエストを送信します。

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

次の変数を、実際の環境の値に置き換えます。

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • ZONE: インスタンスが配置されているゾーン。
  • INSTANCE_NAME: VM インスタンスの名前または ID。

次の JSON スニペットは、インスタンスにインストールされている拡張機能の状態を一覧表示するレスポンスの例を示しています。

{
  "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"
    }
  ]
}

インスタンス上の特定の VM 拡張機能の状態を表示する

複数のポリシーが VM をターゲットにしている場合や、インストールされた拡張機能が想定どおりに動作していない場合は、その特定の拡張機能の状態を表示して、最終的な有効な構成（policyId とバージョン）と診断ステータス メッセージを確認します。

インスタンス上の特定の VM 拡張機能の有効な状態と管理ポリシーを表示するには、次のいずれかのオプションを選択します。

gcloud

インスタンス上の特定の VM 拡張機能の有効な状態、アクティブなバージョン、管理ポリシーを取得するには、gcloud beta compute instances get-vm-extension-state コマンドを実行します。

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

次の変数を、実際の環境の値に置き換えます。

  • INSTANCE_NAME: VM インスタンスの名前。
  • EXTENSION_NAME: 検査する拡張機能の名前（例: ops-agent）。
  • ZONE: インスタンスが配置されているゾーン。
  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。

REST

インスタンス上の特定の VM 拡張機能の有効な状態、アクティブなバージョン、管理ポリシーを取得するには、instances.getVmExtensionState メソッドに GET リクエストを送信します。

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

次の変数を、実際の環境の値に置き換えます。

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • ZONE: インスタンスが配置されているゾーン。
  • INSTANCE_NAME: VM インスタンスの名前または ID。
  • EXTENSION_NAME: VM 拡張機能の名前（例: ops-agent）。

次の JSON スニペットは、インスタンス上の単一の VM 拡張機能の状態に対するレスポンスの例を示しています。

{
  "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"
}

VM 拡張機能の状態フィールドを解釈する

インスタンスの VM 拡張機能の状態を取得すると、レスポンスには、適用されたポリシー、アクティブなバージョン、インストールの進行状況、プラグインのランタイムの健全性を報告するフィールドが含まれます。

次の表に、VmExtensionState リソースが返すフィールドを示します。

フィールド 説明
name VM 拡張機能の識別子（例: ops-agent）。
version VM インスタンスにインストールされている拡張機能のアクティブなバージョン。
policyId インスタンスでこの拡張機能を適用する有効な VM 拡張機能ポリシーの識別子。複数のポリシーが VM をターゲットにしている場合、このフィールドには優先度解決後に適用されるポリシーが表示されます。
enforcementState 拡張機能の適用プロセスの現在のライフサイクル ステータス。有効な値は次のとおりです。
  • ENFORCEMENT_STATE_UNSPECIFIED: 適用状態が指定されていません。
  • INSTALLING: ゲスト エージェントが拡張機能をインストールしています。
  • INSTALLED: 拡張機能がインスタンスにインストールされています。
  • INSTALL_FAILED: インストールが失敗し、ロールバックに使用できる以前の安定したリビジョンがありません。
  • ROLLING_BACK: ゲスト エージェントは、最後に記録された安定版リビジョンに拡張機能をロールバックしています。
  • ROLLED_BACK: 拡張機能が最後の安定したリビジョンにロールバックされました。
  • ROLLBACK_FAILED: ロールバックの試行が失敗しました。
  • INCOMPATIBLE: 拡張機能バージョンで使用可能なリビジョンの中に、VM のオペレーティング システムまたはアーキテクチャと互換性のあるものがない。
  • REMOVING: ゲスト エージェントがインスタンスから拡張機能を削除しています。
  • SERVICE_DISABLED: この拡張機能に必要なサービス API がプロジェクトで無効になっています。
  • APPLYING_CONFIG: ゲスト エージェントが拡張機能に新しい構成を適用しています。これには、プラグインの再起動が必要になる場合があります。
enforcementMsg 拡張機能が適用に失敗した場合、またはインストール エラーが発生した場合に、ゲスト エージェントが返す診断ステータス メッセージ。
healthStatus 適用された拡張機能プラグインのランタイム ヘルス ステータス。拡張機能がまだ適用されていない場合、この値は指定されません。有効な値は次のとおりです。
  • HEALTH_STATUS_UNSPECIFIED: ヘルス ステータスが指定されていません。
  • STARTING: 拡張機能プロセスが開始しています。
  • RUNNING: 拡張機能プロセスは正常に実行されています。
  • STOPPING: 拡張機能プロセスが停止しています。
  • STOPPED: 拡張機能プロセスが停止しています。
  • CRASHED: 拡張機能プロセスは開始されましたが、予期せず停止しました。
healthMsg 拡張機能が健全性ステータスについて報告する診断メッセージ（Plugin is running ok など）。

次のステップ