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

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

このドキュメントでは、 Cloud de Confiance by S3NS リソース階層全体で読み取り専用の 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 を使用する必要があります。Cloud de Confiance コンソールで 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 ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

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

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

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

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

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

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

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

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

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

必要な IAM 権限

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

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

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

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

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

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

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

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

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

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

必要な IAM 権限

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

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

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

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

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

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

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

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

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

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

必要な IAM 権限

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

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

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

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

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

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

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

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

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

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

必要な IAM 権限

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

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

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

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

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

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

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

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

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

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

必要な IAM 権限

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

必要な IAM 権限

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

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

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

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

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

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

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

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

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

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

必要な IAM 権限

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

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

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

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

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

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

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

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

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

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

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

必要な IAM 権限

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

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

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

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

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

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

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

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

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

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

必要な IAM 権限

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

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

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

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

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

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

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

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

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

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

必要な IAM 権限

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

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

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

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

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

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

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

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

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

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

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

EXTENSION_NAME  ENFORCEMENT_STATE  HEALTH_STATUS
ops-agent       INSTALLED          RUNNING

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

{
  "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 beta compute instances get-vm-extension-state INSTANCE_NAME \
    --extension-name=EXTENSION_NAME \
    --zone=ZONE \
    --project=PROJECT_ID

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

{
  "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 リソースが返すフィールドを示します。

次のステップ

• 失敗したロールアウトの診断、実行中のゲストプロセスの確認、ゲスト エージェントのデバッグログの検査を行うには、VM 拡張機能のトラブルシューティングをご覧ください。
• Cloud Logging で過去の適用イベントをクエリし、インストールまたはクラッシュのレコードを監査するには、VM 拡張機能のログを表示するをご覧ください。
• Cloud Monitoring ダッシュボードを構築し、エージェントの健全性、CPU、メモリ使用量のアラートを設定するには、VM 拡張機能をモニタリングするをご覧ください。
• 構成設定の変更、固定バージョンの変更、デプロイされたエージェントの削除を行うには、拡張機能ポリシーを使用して VM 拡張機能を管理するをご覧ください。