워크로드 정책 보기

이 문서에서는 워크로드 정책을 보는 방법을 설명합니다.

관리형 인스턴스 그룹 (MIG)에 워크로드 정책을 만들고 적용한 후에는 해당 정책의 구성 세부정보를 볼 수 있습니다. 워크로드 정책을 보면 프로젝트의 모든 워크로드 정책을 개략적으로 파악하거나 특정 정책의 구성 세부정보를 확인할 수 있습니다.

워크로드 정책을 만들 때 적용되는 요구사항 및 제한사항에 대해 자세히 알아보려면 워크로드 정책 정보를 참조하세요.

시작하기 전에

필요한 역할

워크로드 정책을 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 인스턴스 관리자 (v1) (roles/compute.instanceAdmin.v1) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 워크로드 정책을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

워크로드 정책을 보려면 다음 권한이 필요합니다.

  • 워크로드 정책 목록 보기: compute.resourcePolicies.list on the project
  • 워크로드 정책 세부정보 보기: compute.resourcePolicies.get on the project

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

워크로드 정책 보기

프로젝트에 있는 워크로드 정책을 보려면 다음 방법 중 하나를 사용하세요.

워크로드 정책 목록 보기

프로젝트의 모든 워크로드 정책 목록을 보려면 다음 옵션 중 하나를 선택합니다.

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

특정 리전의 워크로드 정책 목록을 보려면 GET request to the resourcePolicies.list method를 만드세요. 요청 URL에 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

워크로드 정책 세부정보를 보려면 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"
}

다음 단계