Ver políticas de carga de trabalho

Este documento explica como visualizar as políticas de cargas de trabalho.

Depois de criar e aplicar políticas de cargas de trabalho a grupos de instâncias gerenciadas (MIGs), é possível conferir os detalhes de configuração dessas políticas. A visualização das políticas de cargas de trabalho ajuda a ter uma visão geral de todas as políticas de cargas de trabalho no seu projeto ou a verificar os detalhes de configuração de uma política específica.

Para saber mais sobre os requisitos e limitações que você aplica ao criar políticas de cargas de trabalho, consulte Sobre as políticas de cargas de trabalho.

Antes de começar

Funções exigidas

Para receber as permissões necessárias para visualizar as políticas de cargas de trabalho, peça ao administrador para conceder a você o papel do IAM de Administrador da instância do Compute (v1) (roles/compute.instanceAdmin.v1) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar as políticas de cargas de trabalho. Para acessar as permissões exatas que são necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para visualizar as políticas de cargas de trabalho:

  • Para conferir uma lista das suas políticas de cargas de trabalho: compute.resourcePolicies.list on the project
  • Para conferir os detalhes de uma política de cargas de trabalho: compute.resourcePolicies.get on the project

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Conferir suas políticas de cargas de trabalho

Para conferir as políticas de cargas de trabalho que existem no seu projeto, use um dos seguintes métodos:

Conferir uma lista das suas políticas de cargas de trabalho

Para conferir uma lista de todas as políticas de cargas de trabalho no seu projeto, selecione uma das seguintes opções:

gcloud

Para visualizar uma lista de políticas de cargas de trabalho, use o gcloud compute resource-policies list comando com a --filter flag definida como workloadPolicy:*.

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

O resultado será assim:

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

Para mais informações sobre como usar expressões de filtro para restringir uma lista de recursos do Compute Engine, consulte o comando gcloud topic filters.

REST

Para conferir uma lista de políticas de cargas de trabalho em uma região específica, faça uma GET solicitação para o resourcePolicies.list método. No URL da solicitação, inclua o parâmetro de consulta filter e defina-o como workloadPolicy%3A*.

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

Substitua:

  • PROJECT_ID: o ID do projeto em que você quer acessar uma lista de políticas de cargas de trabalho.

  • REGION: a região em que uma ou mais políticas de cargas de trabalho existem.

O resultado será assim:

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

Para mais informações sobre como usar expressões de filtro para restringir uma lista de políticas de recursos usando codificação de URL, consulte o filter parâmetro de consulta.

Conferir os detalhes de uma política de cargas de trabalho

Para conferir os detalhes de uma política de cargas de trabalho, selecione uma das seguintes opções:

gcloud

Para conferir os detalhes de uma política de cargas de trabalho, use o gcloud compute resource-policies describe comando.

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

Substitua:

  • POLICY_NAME: o nome de uma política de cargas de trabalho.

  • REGION: a região em que a política de cargas de trabalho existe.

O resultado será assim:

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

Para conferir os detalhes de uma política de cargas de trabalho, faça uma GET solicitação para o resourcePolicies.get método.

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

Substitua:

  • PROJECT_ID: o ID do projeto em que a política de cargas de trabalho que você quer conferir os detalhes existe.

  • REGION: a região em que a política de cargas de trabalho existe.

  • POLICY_NAME: o nome de uma política de cargas de trabalho.

O resultado será assim:

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

A seguir