查看工作负载政策

本文档介绍如何查看工作负载政策。

为托管式实例组 (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 Instance Admin (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

如需查看特定区域中的工作负载政策列表，请向 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="
}

如需详细了解如何使用过滤表达式来通过网址编码缩小资源政策列表的范围，请参阅 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"
}

后续步骤