Como excluir uma instância

Nesta página, descrevemos como excluir uma instância. Se em vez de excluir uma instância, você quiser interrompê-la temporariamente, leia Como interromper e iniciar uma instância.

A exclusão remove a instância e os recursos associados do seu projeto. Se a instância fizer parte de um grupo de instâncias, ele poderá tentar recriar uma idêntica para manter um determinado tamanho de grupo. Por isso, Redimensione o grupo de instâncias ou reconfigure o autoescalador.

Antes de começar

• Para usar os exemplos de linha de comando deste guia, siga estas etapas:
  1. Instale ou atualize a ferramenta de linha de comando gcloud para a versão mais recente.
  2. Defina uma região e uma zona padrão.
• Para usar os exemplos de API deste guia, configure o acesso à API.

Excluir uma instância

Permissões necessárias para a tarefa

Para executar esta tarefa, é necessário ter as permissões abaixo.

• compute.instances.delete na instância

Exclua uma instância usando o Console do GCP, o gcloud ou a API.

Console

1. Acesse a página "Instâncias de VMs" no Console do GCP.

   Acessar a página "Instâncias de VMs"

2. Marque as instâncias que você quer excluir.
3. Clique no botão Excluir.

gcloud

Use o comando gcloud compute instances delete. Ao excluir uma instância dessa forma, ela é encerrada e removida da lista de instâncias, e todos os recursos anexados a ela são liberados, como discos permanentes e quaisquer endereços IP estáticos.

Para excluir uma instância, use o seguinte comando:

gcloud compute instances delete example-instance [example-instance-2 example-instance-3..]

API

Use o método delete:

DELETE https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/example-instance

Período de encerramento

Ao encerrar ou excluir uma instância, o Compute Engine envia o sinal ACPI Power Off para a instância e aguarda um breve período para que ela seja encerrada de maneira limpa. Caso sua instância ainda esteja em execução após esse período de espera, o Compute Engine força o encerramento, mesmo que seu script de encerramento ainda esteja em execução.

A duração do período de encerramento depende do tipo de sua instância.

• As instâncias normais têm um período de encerramento que dura, normalmente, o mínimo de 90 segundos, mas pode ser maior.
• As instâncias preemptivas têm um período de encerramento de 30 segundos, a mesma duração do período de encerramento que o corre durante o processo de preempção.

Se você optar por executar um script de encerramento durante esse período, seu script de encerramento precisará terminar a execução dentro desse período para que o sistema operacional tenha tempo de concluir o encerramento e descarregar os buffers para o disco.

Observação: o Compute Engine não garante a duração desses períodos de encerramento. É recomendável que você não dependa desses períodos.

A seguir

• Saiba mais sobre o ciclo de vida da instância.
• Interrompa uma instância em vez de excluí-la permanentemente.