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

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.

    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

    1. Install the Google Cloud CLI, then initialize it by running the following command:

      gcloud init
    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.

        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.

      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:

      1. 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

      2. Em um editor de texto de sua escolha, abra o arquivo de configuração da VM.

      3. 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.

      4. 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:

      1. 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.

      2. 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.

      3. 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:

      É 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