查看工作負載政策

本文說明如何查看工作負載政策。

為代管執行個體群組 (MIG) 建立及套用工作負載政策後，即可查看這些政策的設定詳細資料。查看工作負載政策有助於概覽專案中的所有工作負載政策，或驗證特定政策的設定詳細資料。

如要進一步瞭解建立工作負載政策時套用的規定與限制，請參閱「關於工作負載政策」。

事前準備

  • 如果尚未設定驗證，請先完成設定。 驗證可確認您的身分，以便存取 Google Cloud 服務和 API。如要從本機開發環境執行程式碼或範例，請選取下列其中一個選項，向 Compute Engine 進行驗證：

    選取這個頁面上的分頁，瞭解如何使用範例：

    gcloud

    1. 安裝 Google Cloud CLI。 完成後，執行下列指令來初始化 Google Cloud CLI：

      gcloud init

      若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

  • 設定預設地區和區域。

    • REST

    如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

      安裝 Google Cloud CLI。

      若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

    詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」。

必要的角色

如要取得查看工作負載政策所需的權限，請要求管理員授予您專案的「Compute 執行個體管理員 (v1) 」(roles/compute.instanceAdmin.v1) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備查看工作負載政策所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

必須具備下列權限，才能查看工作負載政策：

  • 如要查看工作負載政策清單： 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

如要查看特定區域中的工作負載政策清單，請向 resourcePolicies.list 方法發出 GET 要求。 在要求網址中加入 filter 查詢參數，並將其設為 workloadPolicy%3A*。

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

更改下列內容：

  • PROJECT_ID：您要查看工作負載政策清單的專案 ID。

  • REGION：一或多個工作負載政策所在的區域。

輸出結果會與下列內容相似：

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

後續步驟