Substituir, remover ou excluir políticas de posicionamento

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Este documento descreve como substituir, remover ou excluir políticas de veiculação.

Substituir, remover ou excluir políticas de posicionamento é útil nos seguintes casos:

• Substitua uma política de posicionamento em uma instância de máquina virtual (VM) para mover a VM para uma posição diferente em relação a outras VMs.

• Remova uma política de posicionamento de uma VM quando você não estiver mais interessado na posição dela em relação a outras VMs.

• Exclua uma política de posicionamento quando não precisar mais dela.

Antes de começar

• Revise as restrições das políticas de posicionamento.
• 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.

  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 substituir, remover ou excluir políticas de posicionamento, peça ao administrador para conceder a você a função do IAM Administrador de instância do Compute (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 .

Essa função predefinida contém as permissões necessárias para substituir, remover ou excluir políticas de posicionamento. Para ver as permissões exatas necessárias, expanda a seção Permissões necessárias :

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

Substituir uma política de posicionamento em uma VM

Antes de substituir uma política de posicionamento espalhado em uma VM por uma política de posicionamento compacto, verifique se a VM usa um tipo de máquina compatível e uma política de manutenção de host . Se você precisar atualizar a VM antes de substituir sua política de posicionamento, siga um ou ambos os procedimentos a seguir:

• Altere a política de manutenção do host da VM .

• Altere o tipo de máquina da VM .

Depois de substituir a política de posicionamento em uma VM, você deverá reiniciar a VM para tornar efetiva a política de posicionamento recém-aplicada.

Para substituir uma política de posicionamento em uma VM, selecione uma das seguintes opções:

Para obter mais informações sobre como atualizar as propriedades de uma VM, consulte Atualizar propriedades da VM .

Remover uma política de posicionamento de uma VM

Se quiser remover uma política de posicionamento de propagação com dois ou mais domínios de disponibilidade de uma VM, você poderá fazer isso sem parar a VM. Se quiser remover uma política de posicionamento compacta ou uma política de posicionamento espalhado com apenas um domínio de disponibilidade, primeiro você deverá parar a VM antes de remover a política de posicionamento anexada a ela.

A remoção de uma política de posicionamento de uma VM não afeta a sua localização física. No entanto, se a VM estiver migrando em tempo real, o Compute Engine poderá movê-la para um local físico diferente.

Para remover uma política de posicionamento de uma VM, selecione uma das seguintes opções:

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

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"
  ]
}

Excluir uma política de canais

Você só poderá 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 ou mais recursos do Compute Engine, siga um destes procedimentos:

• Se a política for aplicada apenas a VMs e você quiser mantê-las, faça o seguinte:

  1. Remova a política de posicionamento das VMs conforme descrito neste documento.

  2. Exclua a política de posicionamento conforme descrito nesta seção.

• Caso contrário, faça o seguinte:

  1. Opcional: Remova a política de posicionamento de qualquer VM que você queira manter conforme descrito neste documento.

  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 conforme descrito nesta seção.

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

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

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

O que vem a seguir?

• Saiba como visualizar as políticas de posicionamento .

• Saiba como fazer o seguinte com uma VM que especifica uma política de posicionamento:

  • Visualize o status da VM .

  • Conecte-se à VM .