Visualizar políticas de posicionamento

Este documento explica como visualizar as políticas de posicionamento. Especificamente, ele explica como visualizar as políticas de posicionamento disponíveis em um projeto específico ou como conferir os detalhes de configuração de uma dessas políticas.

Antes de começar

Funções exigidas

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

Este papel predefinido contém as permissões necessárias para visualizar ou excluir políticas de posicionamento. Para conferir 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 visualizar ou excluir as políticas de posicionamento:

  • Para conferir uma lista das políticas de posicionamento: compute.resourcePolicies.list no projeto
  • Para conferir os detalhes de uma política de posicionamento: compute.resourcePolicies.get no projeto

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

  • Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da 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 da seguinte maneira.

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

    Console

    Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud, não é necessário configurar a autenticação.

    gcloud

    1. Instale a Google Cloud CLI e inicialize-a executando o seguinte comando: 

      gcloud init
    2. Defina uma região e uma zona padrão.

    REST

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

      Instale a Google Cloud CLI e inicialize-a executando o seguinte comando: 

      gcloud init

    • Conferir suas políticas de posicionamento

    Para acessar as políticas de posicionamento disponíveis em um projeto especificado, selecione um dos seguintes métodos:

    Conferir uma lista das suas políticas de posicionamento

    É possível conferir uma lista de todas as políticas de posicionamento em um projeto especificado usando a gcloud CLI e a API Compute Engine.

    gcloud

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

    gcloud compute resource-policies list \
    --filter="groupPlacementPolicy:*" \
    --project=PROJECT_ID

    Substitua PROJECT_ID pelo ID do projeto em que você quer visualizar uma lista de políticas de posicionamento. Se você omitir essa flag, o valor dela será definido como o ID do projeto atual.

    O resultado será assim:

    NAME: policy-1
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2023-07-15T02:10:51.958-08:00

NAME: policy-2
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2023-07-15T02:11:16.826-08: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 posicionamento localizadas em uma região específica, crie uma GET solicitação para o resourcePolicies.list método com o parâmetro de consulta filter definido como groupPlacementPolicy%3A*.

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

    Substitua:

    • PROJECT_ID: o ID do projeto em que você quer visualizar uma lista de políticas de posicionamento.

    • REGION: a região onde uma ou mais políticas de posicionamento estão localizadas.

    O resultado será assim:

    {
  "kind": "compute#resourcePolicyList",
  "id": "projects/example-project/regions/us-central1/resourcePolicies",
  "items": [
    {
      "kind": "compute#resourcePolicy",
      "id": "637231102400797797",
      "creationTimestamp": "2023-07-28T04:12:11.072-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/policy-1",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "policy-1",
      "groupPlacementPolicy": {
        "collocation": "COLLOCATED"
      },
      "status": "READY"
    },
    {
      "kind": "compute#resourcePolicy",
      "id": "1228789480840827204",
      "creationTimestamp": "2023-07-15T02:10:51.958-08:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/policy-2",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "policy-2",
      "groupPlacementPolicy": {
        "availabilityDomainCount": 2
      },
      "status": "READY"
    }
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies",
  "etag": "-L7XCupTQ5V9__TOJ8G5RDcR2cY=/g_xt0udkOM_tU7jSL0z9I2Sivis="
}

    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.

    Consultar detalhes de uma política de posicionamento

    É possível consultar os detalhes de uma política de posicionamento em um projeto especificado usando a gcloud CLI e a API Compute Engine.

    gcloud

    Para conferir os detalhes de uma política de posicionamento , use o comando gcloud compute resource-policies describe:

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

    Substitua:

    • PROJECT_ID: o ID do projeto em que está localizada a política de posicionamento que você quer ver.

    • POLICY_NAME: o nome de uma política de posicionamento existente.

    • REGION: a região em que a política de posicionamento está localizada.

    O resultado será assim:

    creationTimestamp: '2023-07-15T02:10:51.958-08:00'
groupPlacementPolicy:
  availabilityDomainCount: 2
id: '1228789480840827204'
kind: compute#resourcePolicy
name: pp2
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/example-policy
status: READY

    REST

    Para conferir detalhes de uma política de posicionamento, faça uma solicitação GET ao métodoresourcePolicies.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 está localizada a política de posicionamento que você quer ver.

    • REGION: a região em que a política de posicionamento está localizada.

    • POLICY_NAME: o nome de uma política de posicionamento existente.

    O resultado será assim:

    {
  "kind": "compute#resourcePolicy",
  "id": "637231102400797797",
  "creationTimestamp": "2023-07-28T04:12:11.072-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-policy",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "policy-1",
  "groupPlacementPolicy": {
      "availabilityDomainCount": 2
  },
  "status": "READY"
}

    A seguir