Veja as políticas de posicionamento

Este documento descreve como ver as políticas de posicionamento.

A visualização das políticas de posicionamento é útil para ver todas as políticas de posicionamento existentes num projeto ou verificar os detalhes de configuração de uma política de posicionamento específica.

Antes de começar

  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se no Compute Engine selecionando uma das seguintes opções:

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

    gcloud

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

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

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

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

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

Funções necessárias

Para receber as autorizações de que precisa para ver as políticas de posicionamento, peça ao seu administrador para lhe conceder a função de IAM Administrador de instâncias do Compute (v1) (roles/compute.instanceAdmin.v1) no seu projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém as autorizações necessárias para ver políticas de posicionamento. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para ver políticas de posicionamento:

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

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Veja as suas políticas de posicionamento

Para ver as políticas de posicionamento disponíveis num projeto, selecione um dos seguintes métodos descritos neste documento:

Veja uma lista das suas políticas de posicionamento

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

gcloud

Para ver 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:*"

O resultado é semelhante ao seguinte:

NAME: example-compact-policy
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2024-05-09T02:09:24.588-07:00

NAME: example-spread-policy
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2024-05-09T02:08:13.404-07:00

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

REST

Para ver uma lista de políticas de posicionamento localizadas numa região específica, faça um pedido GET ao métodoresourcePolicies.list. No URL do pedido, inclua o parâmetro de consulta filter e defina-o como groupPlacementPolicy%3A*.

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

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto no qual quer ver uma lista de políticas de posicionamento.

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

O resultado é semelhante ao seguinte:

{
  "kind": "compute#resourcePolicyList",
  "id": "projects/example-project/regions/us-central1/resourcePolicies",
  "items": [
    {
      "kind": "compute#resourcePolicy",
      "id": "5587673659722509355",
      "creationTimestamp": "2024-05-09T02:09:24.588-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "example-compact-policy",
      "groupPlacementPolicy": {
        "collocation": "COLLOCATED"
      },
      "status": "READY"
    },
    {
      "kind": "compute#resourcePolicy",
      "id": "5970772604948130963",
      "creationTimestamp": "2024-05-09T02:08:13.404-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "example-spread-policy",
      "groupPlacementPolicy": {
        "availabilityDomainCount": 5
      },
      "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 a utilização de expressões de filtro para restringir uma lista de políticas de recursos através da codificação de URLs, consulte o parâmetro de consultafilter.

Veja os detalhes de uma política de posicionamento

Para ver os detalhes de uma política de posicionamento, selecione uma das seguintes opções:

gcloud

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

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

Substitua o seguinte:

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

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

O resultado é semelhante ao seguinte:

  • Se estiver a ver os detalhes de uma política de posicionamento compacta:

    creationTimestamp: '2024-05-09T02:09:24.588-07:00'
groupPlacementPolicy:
  collocation: COLLOCATED
id: '5587673659722509355'
kind: compute#resourcePolicy
name: example-compact-policy
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-compact-policy
status: READY

  • Se estiver a ver os detalhes de uma política de posicionamento de propagação:

    creationTimestamp: '2024-05-09T02:08:13.404-07:00'
groupPlacementPolicy:
  availabilityDomainCount: 5
id: '5970772604948130963'
kind: compute#resourcePolicy
name: example-spread-policy
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-spread-policy
status: READY

REST

Para ver os detalhes de uma política de posicionamento, faça um pedido GET ao método resourcePolicies.get.

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

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto onde se encontra a política de posicionamento cujos detalhes quer ver.

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

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

O resultado é semelhante ao seguinte:

  • Se estiver a ver os detalhes de uma política de posicionamento compacta:

    {
  "kind": "compute#resourcePolicy",
  "id": "5587673659722509355",
  "creationTimestamp": "2024-05-09T02:09:24.588-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "example-compact-policy",
  "groupPlacementPolicy": {
    "collocation": "COLLOCATED"
  },
  "status": "READY"
}

  • Se estiver a ver os detalhes de uma política de posicionamento de propagação:

    {
  "kind": "compute#resourcePolicy",
  "id": "5970772604948130963",
  "creationTimestamp": "2024-05-09T02:08:13.404-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "example-spread-policy",
  "groupPlacementPolicy": {
    "availabilityDomainCount": 5
  },
  "status": "READY"
}

O que se segue?