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.

    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

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

      gcloud init
    2. Set a default region and zone.
    3. 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:

      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