Ver políticas de posicionamento

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

A visualização das políticas de posicionamento é útil para ver todas as políticas de posicionamento existentes em um 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 fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    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.

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Funções obrigatórias

Para obter as permissões necessárias para visualizar políticas de posicionamento, peça ao administrador para conceder a você a função do IAM Compute Instance Admin (v1) ( roles/compute.instanceAdmin.v1 ) em seu projeto. Para obter mais informações sobre a concessão de funções, consulte Gerenciar acesso a projetos, pastas e organizações .

Esta função predefinida contém as permissões necessárias para visualizar políticas de posicionamento. Para ver 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 as políticas de posicionamento:

  • Para visualizar uma lista de suas políticas de veiculação: compute.resourcePolicies.list on the project
  • Para visualizar os detalhes de uma política de posicionamento: compute.resourcePolicies.get on the project

Você também poderá obter essas permissões com funções personalizadas ou outras funções predefinidas .

Veja suas políticas de posicionamento

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

Veja uma lista de suas políticas de posicionamento

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

gcloud

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

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

A saída é semelhante à 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 obter 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 .

DESCANSAR

Para visualizar uma lista de políticas de veiculação localizadas em uma região específica, faça uma solicitação GET para o método resourcePolicies.list . Na URL de solicitação, inclua o parâmetro de consulta filter e configure-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 você deseja visualizar uma lista de políticas de veiculação.

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

A saída é semelhante à 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 obter 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 de filter .

Ver os detalhes de uma política de canais

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

gcloud

Para visualizar 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.

A saída é semelhante à seguinte:

  • Se você estiver visualizando os detalhes de uma política de posicionamento compacto:

    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 você estiver visualizando os detalhes de uma política de posicionamento de spread:

    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

DESCANSAR

Para visualizar os detalhes de uma política de posicionamento, faça uma solicitação GET para o 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 está localizada a política de canais cujos detalhes você deseja visualizar.

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

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

A saída é semelhante à seguinte:

  • Se você estiver visualizando os detalhes de uma política de posicionamento compacto:

    {
  "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 você estiver visualizando os detalhes de uma política de posicionamento de spread: 

    {
  "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 vem a seguir?