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

Analise as restrições das políticas de posicionamento.

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.

Select the tab for how you plan to use the samples on this page:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

gcloud

Install the Google Cloud CLI, then initialize it by running the following command:
```
gcloud init
```
Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
Set a default region and zone.

REST

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

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

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:

Para conferir todas as políticas de posicionamento, acesse uma lista de políticas de posicionamento.
Para conferir os detalhes de configuração de uma política de posicionamento, veja os detalhes de uma política de posicionamento.

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

Saiba como substituir, remover ou excluir políticas de posicionamento.
Saiba como aplicar uma política de posicionamento:
- Aplique políticas de posicionamento compactas às VMs.
- Aplique políticas de posicionamento propagadas às VMs.