Ver políticas de carga de trabalho

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

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

Para saber mais sobre os requisitos e as limitações aplicados ao criar políticas de carga de trabalho, consulte Sobre as políticas de carga de trabalho.

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a serviços e APIs do Google Cloud . Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine selecionando uma das seguintes opções:

    Selecione a guia para como planeja usar as amostras nesta página:

    gcloud

    1. Instale a CLI do Google Cloud. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando: 

      gcloud init

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

  • Defina uma região e uma zona padrão.

    • REST

    Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

      Instale a CLI do Google Cloud.

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

    Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Funções exigidas

Para receber as permissões necessárias para visualizar as políticas de carga 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 políticas de carga de trabalho. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

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

  • Para conferir uma lista das suas políticas de carga de trabalho: compute.resourcePolicies.list on the project
  • Para conferir os detalhes de uma política de carga 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 carga de trabalho

Para conferir as políticas de carga de trabalho no seu projeto, use um dos métodos a seguir:

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

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

gcloud

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

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

O resultado será o seguinte:

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 carga de trabalho em uma região específica, faça uma solicitação GET para o método resourcePolicies.list. 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 carga de trabalho.

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

O resultado será o seguinte:

{
  "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 parâmetro de consulta filter.

Conferir detalhes de uma política de carga de trabalho

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

gcloud

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

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

Substitua:

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

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

O resultado será o seguinte:

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 carga de trabalho, faça uma solicitação GET ao método resourcePolicies.get.

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 carga de trabalho que você quer conferir os detalhes existe.

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

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

O resultado será o seguinte:

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