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

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

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

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

始める前に

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

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

  gcloud

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

     gcloud init

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

     注: すでに gcloud CLI をインストールしている場合は、最新バージョンがインストールされていることを確認してください gcloud components update を実行して。
• デフォルトのリージョンとゾーンを設定します。

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 on the project
• ワークロード ポリシーの詳細を表示するには: compute.resourcePolicies.get on the project

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

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

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

• プロジェクト内の既存のワークロード ポリシーをすべて確認するには、 ワークロード ポリシーのリストを表示します。

• 特定のワークロード ポリシーの構成の詳細を確認するには、 ワークロード ポリシーの詳細を表示します。

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

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

gcloud

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

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

特定のリージョンのワークロード ポリシーのリストを表示するには、GET メソッドに resourcePolicies.listリクエストを行います。 リクエスト 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

ワークロード ポリシーの詳細を表示するには、GET リクエストを resourcePolicies.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"
}

次のステップ

• ワークロード ポリシーを 置換、削除、消去する方法を学習する。