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.
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
- Set a default region and zone.
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.
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.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.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.Saiba como substituir, remover ou excluir políticas de posicionamento.
Saiba como aplicar uma política de posicionamento:
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:
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:
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:
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
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-09-24 UTC.