Substituir, remover ou excluir políticas de carga de trabalho

Este documento explica como substituir, remover ou excluir políticas de carga de trabalho de grupos gerenciados de instâncias (MIGs). Essas ações são úteis nos seguintes cenários:

  • Substituir uma política de carga de trabalho: é possível mudar a forma como as instâncias do Compute Engine são localizadas no MIG ou mudar para uma política de carga de trabalho diferente que se ajuste melhor aos requisitos da sua carga de trabalho.

  • Remover uma política de carga de trabalho: é possível parar de usar regras de posicionamento específicas se a carga de trabalho não precisar mais delas, revertendo o MIG para o comportamento padrão de posicionamento de instâncias de computação.

  • Excluir uma política de carga de trabalho: é possível excluir permanentemente políticas de carga de trabalho que não são mais necessárias.

Para saber como criar uma política de carga de trabalho, consulte Criar políticas de carga de trabalho para MIGs.

Limitações

Só é possível substituir ou remover uma política de carga de trabalho de um MIG se não houver instâncias de computação nele.

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma 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 selecionando uma das seguintes opções:

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

    gcloud

    1. Instale a CLI do Google Cloud. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando: 

      gcloud init

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

  • 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 CLI gcloud.

      Instale a CLI do Google Cloud.

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

    Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Funções exigidas

Para receber as permissões necessárias para substituir, remover ou excluir políticas de carga de trabalho, peça ao administrador para conceder a você o papel do IAM de Administrador da instância do Compute (v1) (roles/compute.instanceAdmin.v1) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

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

  • Para substituir ou remover uma política de carga de trabalho de um MIG: compute.instances.update no projeto
  • Para excluir uma política de carga de trabalho: compute.resourcePolicies.delete no projeto

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Substituir uma política de carga de trabalho em um MIG

Para substituir uma política de carga de trabalho em um MIG por outra política de carga de trabalho diferente, selecione uma das seguintes opções:

gcloud

  1. Defina manualmente o tamanho do MIG como 0.

  2. Para substituir a política de carga de trabalho no MIG, use o comando gcloud compute instance-groups managed update com a flag --workload-policy. Com base no tipo de MIG, inclua uma das seguintes flags:

    • Para substituir a política de carga de trabalho em um MIG zonal, inclua a flag --zone:

      gcloud compute instance-groups managed update MIG_NAME \
    --workload-policy=WORKLOAD_POLICY \
    --zone=ZONE

    • Para substituir a política de carga de trabalho em um MIG regional, inclua a flag --region:

      gcloud compute instance-groups managed update MIG_NAME \
    --workload-policy=WORKLOAD_POLICY \
    --region=REGION

    Substitua:

    • MIG_NAME: o nome do MIG;

    • WORKLOAD_POLICY: o nome da política de carga de trabalho que você quer aplicar ao MIG.

    • ZONE: a zona em que o MIG zonal está.

    • REGION: a região em que o MIG regional e a política de carga de trabalho existem.

REST

  1. Defina manualmente o tamanho do MIG como 0.

  2. Para substituir a política de carga de trabalho no MIG, faça uma solicitação PATCH a um dos seguintes métodos:

    • Para substituir a política de carga de trabalho em um MIG zonal, faça uma solicitação PATCH para o método compute.instanceGroupManagers.patch:

      PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": "projects/PROJECT_ID/regions/REGION/resourcePolicies/WORKLOAD_POLICY"
}

    • Para substituir a política de carga de trabalho em um MIG regional, faça uma solicitação PATCH para o método compute.regionInstanceGroupManagers.patch:

      PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": "projects/PROJECT_ID/regions/REGION/resourcePolicies/WORKLOAD_POLICY"
}

    Substitua:

    • PROJECT_ID: o ID do projeto em que o MIG e a política de carga de trabalho estão.

    • ZONE: a zona em que o MIG zonal está.

    • REGION: a região em que o MIG regional e a política de carga de trabalho existem.

    • MIG_NAME: o nome do MIG.

    • WORKLOAD_POLICY: o nome da política de carga de trabalho que você quer aplicar ao MIG.

Remover uma política de carga de trabalho de um MIG

Para remover uma política de carga de trabalho de um MIG, selecione uma das seguintes opções:

gcloud

  1. Defina manualmente o tamanho do MIG como 0.

  2. Para remover uma política de carga de trabalho de um MIG, use o comando gcloud compute instance-groups managed update com a flag --remove-workload-policy. Com base no tipo de MIG, inclua uma das seguintes flags:

    • Para remover uma política de carga de trabalho de um MIG zonal, inclua a flag --zone:

      gcloud compute instance-groups managed update MIG_NAME \
    --remove-workload-policy=WORKLOAD_POLICY \
    --zone=ZONE

    • Para remover uma política de carga de trabalho de um MIG regional, inclua a flag --region:

      gcloud compute instance-groups managed update MIG_NAME \
    --remove-workload-policy=WORKLOAD_POLICY \
    --region=REGION

    Substitua:

    • MIG_NAME: o nome do MIG.

    • WORKLOAD_POLICY: o nome da política de carga de trabalho aplicada ao MIG.

    • ZONE: a zona em que o MIG zonal está.

    • REGION: a região em que o MIG regional está localizado.

REST

  1. Defina manualmente o tamanho do MIG como 0.

  2. Para remover uma política de carga de trabalho de um MIG, faça uma solicitação PATCH para um dos seguintes métodos:

    • Para remover uma política de carga de trabalho de um MIG zonal, faça uma solicitação para o método compute.instanceGroupManagers.patch:

      PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": ""
}

    • Para remover uma política de carga de trabalho de um MIG regional, faça uma solicitação para o método compute.regionInstanceGroupManagers.patch:

      PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": ""
}

    Substitua:

    • PROJECT_ID: o ID do projeto em que o MIG e a política de carga de trabalho estão.

    • ZONE: a zona em que o MIG zonal está.

    • REGION: a região em que o MIG regional e a política de carga de trabalho existem.

    • MIG_NAME: o nome do MIG.

Excluir uma política de carga de trabalho

Não é possível excluir uma política de carga de trabalho aplicada a um MIG. Antes de excluir a política, remova-a do MIG.

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

gcloud

Para excluir uma política de carga de trabalho, use o comando gcloud compute resource-policies delete:

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

Substitua:

  • WORKLOAD_POLICY: o nome de uma política de carga de trabalho.

  • REGION: a região em que a política de carga de trabalho existe.

REST

Para excluir uma política de carga de trabalho, 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 carga de trabalho existe.

  • REGION: a região em que a política de carga de trabalho existe.

  • POLICY_NAME: o nome de uma política de carga de trabalho.

A seguir