ワークロード ポリシーを表示する

このドキュメントでは、ワークロード ポリシーを表示する方法について説明します。

ワークロード ポリシーを作成してマネージド インスタンス グループ（MIG）に適用すると、これらのポリシーの構成の詳細を表示できます。ワークロード ポリシーを表示すると、プロジェクト内のすべてのワークロード ポリシーの概要を確認したり、特定のポリシーの構成の詳細を確認できます。

ワークロード ポリシーを作成するときに適用する要件と制限事項の詳細については、ワークロード ポリシーについてをご覧ください。

始める前に

  • まだ設定していない場合は、認証を設定します。認証では、 Google Cloud サービスと API にアクセスするための ID が確認されます。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。

    このページのサンプルをどのように使うかに応じて、タブを選択してください。

    gcloud

    1. Google Cloud CLI をインストールします。インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。

      gcloud init

      外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

  • デフォルトのリージョンとゾーンを設定します。

    • REST

    このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

      Google Cloud CLI をインストールします。

      外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

    詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

必要なロール

ワークロード ポリシーを表示するために必要な権限を取得するには、プロジェクトに対する Compute インスタンス管理者（v1） （roles/compute.instanceAdmin.v1）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

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

必要な権限

ワークロード ポリシーを表示するには、次の権限が必要です。

  • ワークロード ポリシーのリストを表示するには: プロジェクトに対する compute.resourcePolicies.list
  • ワークロード ポリシーの詳細を表示する: プロジェクトに対する compute.resourcePolicies.get

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

ワークロード ポリシーを表示する

プロジェクトに存在するワークロード ポリシーを表示するには、次のいずれかの方法を使用します。

ワークロード ポリシーのリストを表示する

プロジェクト内のすべてのワークロード ポリシーのリストを表示するには、次のいずれかのオプションを選択します。

gcloud

ワークロード ポリシーのリストを表示するには、--filter フラグを workloadPolicy:* に設定して gcloud compute resource-policies list コマンドを使用します。

gcloud compute resource-policies list \
    --filter="workloadPolicy:*"

出力は次のようになります。

NAME: workload-policy-01
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2026-03-18T02:20:11.010-07:00

NAME: workload-policy-02
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2026-03-18T09:24:58.281-07:00

フィルタ式を使用して Compute Engine リソースのリストを絞り込む方法については、gcloud topic filters コマンドをご覧ください。

REST

特定のリージョンのワークロード ポリシーのリストを表示するには、resourcePolicies.list メソッドに GET リクエストを送信します。リクエスト URL に filter クエリ パラメータを含め、workloadPolicy%3A* に設定します。

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies?filter=workloadPolicy%3A*

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

  • PROJECT_ID: ワークロード ポリシーのリストを表示するプロジェクトの ID。

  • REGION: 1 つ以上のワークロード ポリシーが存在するリージョン。

出力は次のようになります。

{
  "kind": "compute#resourcePolicyList",
  "id": "projects/example-project/regions/us-central1/resourcePolicies",
  "items": [
    {
      "workloadPolicy": {
        "type": "HIGH_THROUGHPUT"
      },
      "kind": "compute#resourcePolicy",
      "id": "7592369487854686373",
      "creationTimestamp": "2026-03-18T02:20:11.010-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-01",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "workload-policy-01",
      "status": "READY"
    },
    {
      "workloadPolicy": {
        "type": "HIGH_THROUGHPUT",
        "maxTopologyDistance": "BLOCK"
      },
      "kind": "compute#resourcePolicy",
      "id": "5947350722329145141",
      "creationTimestamp": "2026-03-18T09:24:58.281-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-02",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "workload-policy-02",
      "status": "READY"
    }
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies",
  "etag": "ntWQ-oLKD9MWsxuxLOpT5pDF0To=/2MdxB9oc-_-zK6Z7g0OIqrUQ0BI="
}

URL エンコードを使用しているリソース ポリシーのリストを絞り込むフィルタ式を使用する場合について詳しくは、filterクエリ パラメータをご覧ください。

ワークロード ポリシーの詳細を表示する

ワークロード ポリシーの詳細を表示するには、次のいずれかのオプションを選択します。

gcloud

ワークロード ポリシーの詳細を表示するには、gcloud compute resource-policies describe コマンドを使用します。

gcloud compute resource-policies describe POLICY_NAME \
    --region=REGION

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

  • POLICY_NAME: 既存のワークロード ポリシーの名前。

  • REGION: ワークロード ポリシーが存在するリージョン。

出力は次のようになります。

creationTimestamp: '2026-03-18T02:20:11.010-07:00'
id: '7592369487854686373'
kind: compute#resourcePolicy
name: workload-policy-01
region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-01
status: READY
workloadPolicy:
  type: HIGH_THROUGHPUT

REST

ワークロード ポリシーの詳細を表示するには、resourcePolicies.get メソッドに GET リクエストを送信します。

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME

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

  • PROJECT_ID: 詳細を表示するワークロード ポリシーが存在するプロジェクトの ID。

  • REGION: ワークロード ポリシーが存在するリージョン。

  • POLICY_NAME: 既存のワークロード ポリシーの名前。

出力は次のようになります。

{
  "workloadPolicy": {
    "type": "HIGH_THROUGHPUT"
  },
  "kind": "compute#resourcePolicy",
  "id": "7592369487854686373",
  "creationTimestamp": "2026-03-18T02:20:11.010-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-01",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "workload-policy-01",
  "status": "READY"
}

次のステップ