Substituir, remover ou excluir políticas de posicionamento

Este documento explica como gerenciar as políticas de posicionamento. Especificamente:

Atualize as propriedades de uma instância de máquina virtual (VM) que especifica uma política de posicionamento para executar um dos seguintes procedimentos:
- Substitua a política de posicionamento por outra existente.
- Remova a política.
Exclua uma política de posicionamento de que você não precisa mais.

Antes de começar

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

Funções exigidas

Para receber as permissões necessárias para substituir, remover ou excluir políticas de posicionamento, peça ao administrador para conceder a você Administrador de instâncias do Compute (v1) (roles/compute.instanceAdmin.v1) papel do IAM no projeto. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Esse papel predefinido contém as permissões necessárias para substituir, remover 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 substituir, remover ou excluir políticas de posicionamento:

Para atualizar as propriedades de uma VM: compute.instances.update no projeto
Para excluir uma política de posicionamento: compute.resourcePolicies.delete 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.

Selecione a guia para como planeja usar as amostras nesta página:

Console

Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud, não é necessário configurar a autenticação.

gcloud

Instale a Google Cloud CLI e inicialize-a executando o seguinte comando:
```
gcloud init
```
Observação: se você instalou a CLI gcloud anteriormente, verifique se tem a versão mais recente executando gcloud components update.
Defina uma região e uma zona padrão.

REST

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

Instale a Google Cloud CLI e inicialize-a executando o seguinte comando:

gcloud init

Substituir uma política de posicionamento em uma VM:

É possível substituir a política de posicionamento especificada em uma VM por outra usando a CLI gcloud e a API Compute Engine.

gcloud

Para substituir uma política de posicionamento em uma VM por outra, siga estas etapas:

Para exportar as propriedades de uma VM atual, use o comando gcloud compute instances export.
```
gcloud compute instances export VM_NAME \
    --destination=FILE_PATH \
    --project=PROJECT_ID \
    --zone=ZONE
```
Substitua:
- VM_NAME: o nome de uma VM atual que especifica uma política de posicionamento.
- FILE_PATH: o caminho em que você quer salvar o arquivo de configuração da VM.
- PROJECT_ID: o ID do projeto em que a política de posicionamento e a VM estão localizadas.
- ZONE: é a zona em que a VM está localizada
Em um editor de texto de sua escolha, abra o arquivo de configuração da VM.
Para substituir a política de posicionamento por outra, substitua o valor no campo resourcePolicies por outra.
```
...
resourcePolicies:
- https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/another-example-policy
...
```
Também é possível modificar outras propriedades da VM. Para mais informações, consulte Propriedades que podem ser atualizadas.
Siga as etapas restantes em Atualizar propriedades da VM.

REST

Para substituir uma política de posicionamento em uma VM por outra, siga estas etapas:

Para exportar as propriedades de uma VM atual, faça uma solicitação GET para o método instances.get.
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
```
Substitua:
- PROJECT_ID: o ID do projeto em que a VM está localizada.
- ZONE: é a zona em que a VM está localizada
- VM_NAME: o nome de uma VM atual que especifica uma política de posicionamento.
Para substituir a política de posicionamento por outra, substitua o valor no campo resourcePolicies por outra.
```
{
...
"resourcePolicies": [
  "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/another-example-policy"
],
...
}
```
Também é possível modificar outras propriedades da VM. Para mais informações, consulte Propriedades que podem ser atualizadas.
Siga as etapas restantes em Atualizar propriedades da VM.

Remover uma política de posicionamento de uma VM

É possível remover a política de posicionamento aplicada a uma VM usando a CLI gcloud e a API Compute Engine.

gcloud

Para remover uma política de posicionamento de uma VM, use o comando gcloud compute instances remove-resource-policies.

gcloud compute instances remove-resource-policies VM_NAME \
    --project=PROJECT_ID \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

Substitua:

VM_NAME: o nome de uma VM atual que especifica uma política de posicionamento.
PROJECT_ID: o ID do projeto em que a VM e a política de posicionamento aplicada a ela estão localizadas.
POLICY_NAME: o nome da política de posicionamento aplicada à VM. Para verificar o nome da política de posicionamento, visualize os detalhes da VM e veja o campo resourcePolicies.
ZONE: a zona em que a VM está localizada.

REST

Para remover uma política de posicionamento de uma VM, faça uma solicitação POST ao método instances.removeResourcePolicies.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/removeResourcePolicies

{
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}

Substitua:

PROJECT_ID: o ID do projeto em que a VM e a política de posicionamento aplicada a ela estão localizadas.
ZONE: é a zona em que a VM está localizada
VM_NAME: o nome de uma VM atual que especifica uma política de posicionamento.
REGION: a região em que a política de posicionamento está localizada.
POLICY_NAME: o nome da política de posicionamento aplicada à VM. Para verificar o nome da política de posicionamento, visualize os detalhes da VM e veja o campo resourcePolicies.

Excluir uma política de posicionamento

Só é possível excluir uma política de posicionamento se ela não for aplicada a nenhum recurso do Compute Engine. Caso contrário, a exclusão da política de posicionamento falhará. Se você quiser excluir uma política de posicionamento aplicada a um recurso do Compute Engine, siga um destes procedimentos:

Se a política for aplicada apenas às VMs e você quiser mantê-las, faça o seguinte:
1. Remova a política de posicionamento das VMs.
2. Exclua a política de posicionamento.
Caso contrário, faça o seguinte:
1. Opcional: remova a política de posicionamento de qualquer VM que queira manter.
2. Exclua todos os outros recursos do Compute Engine aos quais a política de posicionamento é aplicada na seguinte ordem:
  1. VMs
  2. Reservas
  3. Modelos de instância
3. Exclua a política de posicionamento.

É possível excluir uma política de posicionamento usando a CLI gcloud e a API Compute Engine.

gcloud

Para excluir uma política de convidado, use o comando gcloud compute resource-policies delete.

gcloud compute resource-policies delete POLICY_NAME \
    --project=PROJECT_ID \
    --region=REGION

Substitua:

POLICY_NAME: o nome de uma política de posicionamento existente.
PROJECT_ID: o ID do projeto em que a política de posicionamento está localizada.
REGION: a região em que a política de posicionamento está localizada.

REST

Para excluir uma política de posicionamento, faça uma solicitação DELETE ao método resourcePolicies.delete.

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

Substitua:

PROJECT_ID: o ID do projeto em que a política de posicionamento está localizada.
REGION: a região em que a política de posicionamento está localizada.
POLICY_NAME: o nome de uma política de posicionamento existente.

A seguir

Saiba como consultar as políticas de posicionamento.
Aprenda a fazer o seguinte com uma VM que especifica uma política de posicionamento:
- Ver o status da VM.
- Conecte-se à VM.