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 ou Como suspender e retomar 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, 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
-
Configure a autenticação.
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
- Defina uma região e uma zona padrão.
C#
Para usar as amostras de .NET nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.
- Instale a CLI do Google Cloud.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
-
Crie as credenciais de autenticação para sua Conta do Google:
gcloud auth application-default login
Veja mais informações em: Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para usar as amostras de Go nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.
- Instale a CLI do Google Cloud.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
-
Crie as credenciais de autenticação para sua Conta do Google:
gcloud auth application-default login
Veja mais informações em: Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para usar as amostras de Java nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.
- Instale a CLI do Google Cloud.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
-
Crie as credenciais de autenticação para sua Conta do Google:
gcloud auth application-default login
Veja mais informações em: Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para usar as amostras de Node.js nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.
- Instale a CLI do Google Cloud.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
-
Crie as credenciais de autenticação para sua Conta do Google:
gcloud auth application-default login
Veja mais informações em: Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para usar as amostras de PHP nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.
- Instale a CLI do Google Cloud.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
-
Crie as credenciais de autenticação para sua Conta do Google:
gcloud auth application-default login
Veja mais informações em: Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para usar as amostras de Python nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.
- Instale a CLI do Google Cloud.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
-
Crie as credenciais de autenticação para sua Conta do Google:
gcloud auth application-default login
Veja mais informações em: Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para usar as amostras de Ruby nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.
- Instale a CLI do Google Cloud.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
-
Crie as credenciais de autenticação para sua Conta do Google:
gcloud auth application-default login
Veja mais informações em: Configurar a autenticação para um ambiente de desenvolvimento local.
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
-
Excluir uma instância
Exclua uma instância usando o console do Google Cloud, a CLI do Google Cloud ou a API.
Console
- Acesse a página "Instâncias de VMs" no Console do Google Cloud.
- Marque as instâncias que você quer excluir.
- Clique no botão Excluir.
gcloud
Use o comando gcloud compute instances delete
. Quando você exclui 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..]
C#
Go
Java
Node.js
PHP
Python
Ruby
REST
Use o método delete
:
DELETE https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/example-instance
Implicações no faturamento
Depois de excluir uma instância de VM, você não receberá mais cobranças por ela, a menos que uma das situações a seguir seja aplicável:
- Se você excluir uma VM hospedada em um nó de locatário individual, continuará pagando por esse nó em vez das VMs individuais hospedadas nele.
- Se você tiver um contrato de uso contínuo, continuará pagando pelos recursos com os quais se comprometeu, independentemente de usá-los ou não.
- Se você mantiver qualquer recurso que foi anexado à instância de VM, continuará recebendo cobranças por ele até excluí-lo. Por exemplo, se você remover a instância de VM, mas mantiver o disco permanente, continuará recebendo cobranças por ele.
Para ver informações mais detalhadas sobre valores, consulte Preços das instâncias de VM.
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 ocorre 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.
A seguir
- Saiba mais sobre o ciclo de vida da instância.
- Interrompa uma instância em vez de excluí-la permanentemente.
- Suspenda uma instância em vez de excluí-la permanentemente.
- Limite o ambiente de execução de uma VM para programar a exclusão automática de uma VM, em vez de excluí-la manualmente.