Neste documento, descrevemos como excluir instâncias de máquina virtual (VM).
Se você não precisar mais de uma VM, exclua-a para interromper as cobranças pela VM e pelos recursos anexados. Se você quiser preservar um recurso anexado, siga um ou mais procedimentos a seguir antes de excluir a VM:
Para preservar uma GPU anexada a uma VM N1 que você quer excluir, remova a GPU da VM.
Para preservar um Persistent Disk, siga um destes procedimentos:
Para preservar um disco de inicialização, remova-o da VM.
Para preservar um disco de inicialização ou sem inicialização, defina a configuração de exclusão automática como
false
.
Antes de começar
-
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.
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
-
Install the Google Cloud CLI, then initialize it by running the following command:
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.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
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.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
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.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
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.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
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.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
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.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
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.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create local authentication credentials for your user account:
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.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
-
Funções exigidas
Para ter as permissões necessárias para excluir uma VM, 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 como conceder papéis, consulte Gerenciar acesso.
Esse papel predefinido contém as permissões necessárias para excluir uma VM. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As permissões a seguir são necessárias para excluir uma VM:
compute.instances.delete
na VM-
Para forçar a exclusão de um Persistent Disk anexado:
compute.disks.delete
no disco
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Implicações no faturamento
Depois de excluir uma VM, o Google Cloud não cobrará mais pela VM e pelos recursos anexados, a menos que uma das seguintes situações se aplique:
Se você excluir uma VM hospedada em um nó de locatário individual, continuará pagando por esse nó no lugar das VMs individuais hospedadas nele.
Se você tiver um desconto por compromisso de uso, continuará pagando pelos recursos com que se comprometeu, independentemente de usá-los ou não.
Se você preservar qualquer recurso que foi anexado à VM, continuará recebendo cobranças por ele até excluí-lo. Por exemplo, se você excluir uma VM, mas preservar os volumes do Persistent Disk anexados a ela, continuará havendo cobranças pelos discos.
Para mais informações, consulte Preços de instâncias de VM.
Processo para excluir uma VM
Ao excluir uma VM, o Compute Engine faz isto:
O Compute Engine envia o sinal de encerramento da ACPI para a VM e, em seguida, define o estado da VM como
STOPPING
em alguns segundos.O Compute Engine inicia um encerramento limpo do sistema operacional (SO) na VM. O período de encerramento dura com base no tipo de VM, conforme a seguir:
VMs preemptivas: têm um período de encerramento de 30 segundos, que é a mesma duração do processo de preempção.
Outros tipos de VM: qualquer outro tipo de VM tem um período de encerramento de pelo menos 90 segundos.
No final do período de encerramento, o Compute Engine exclui permanentemente a VM e os recursos anexados. Se você configurou um Persistent Disk para ser preservado ao excluir a VM a que ele está anexado, o Compute Engine preservará o disco após a exclusão da VM.
Excluir VMs
Para excluir uma ou mais VMs, consulte uma das seguintes seções deste documento:
Para excluir VMs e todos os recursos anexados (padrão), consulte Excluir VMs e todos os recursos anexados.
Para excluir VMs, mas preservar os volumes do Persistent Disk anexados, consulte Excluir VMs e preservar volumes do Persistent Disk.
Excluir VMs e todos os recursos anexados
Ao excluir uma VM, o Compute Engine exclui a VM e todos os recursos anexados por padrão. No entanto, se você configurou um Persistent Disk para ser preservado após a exclusão da VM, será possível substituir essa configuração e excluir a VM e o disco usando a gcloud CLI.
Para excluir várias VMs simultaneamente, use o console do Google Cloud ou, no caso de VMs localizadas na mesma zona, a gcloud CLI. Caso contrário, para excluir uma única VM, use qualquer método descrito nesta seção.
Console
Para excluir uma ou mais VMs, faça isto:
No console do Google Cloud, acesse a página Instâncias de VMs.
Selecione as VMs que você quer excluir.
Clique em
Excluir e depois em Excluir novamente para confirmar.
gcloud
Para excluir uma ou mais VMs, use o comando gcloud compute instances delete
.
gcloud compute instances delete VM_NAMES \
--zone=ZONE
Substitua:
VM_NAMES
: uma lista separada por espaços em branco de nomes de VMs que estão localizadas na mesma zona, por exemplo,vm-01 vm-02 vm-03
.ZONE
: a zona da VM.
Se preferir, para forçar a exclusão dos volumes do Persistent Disk anexados a uma ou mais VMs, inclua a flag --delete-disks
.
gcloud compute instances delete VM_NAMES \
--delete-disks=DELETE_DISK_TYPE \
--zone=ZONE
Substitua DELETE_DISK_TYPE
pelo tipo de volumes do Persistent Disk anexados que serão excluídos. Especifique um dos seguintes valores:
Para excluir todos os tipos de discos:
all
.Para excluir apenas discos de inicialização:
boot
.Para excluir apenas discos sem inicialização:
data
.
C#
Go
Java
Node.js
PHP
Python
Ruby
REST
Para excluir uma VM, faça uma solicitação DELETE
para o método instances delete
.
DELETE 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 da VM.VM_NAME
: o nome da VM.
Excluir VMs e preservar volumes do Persistent Disk
Por padrão, excluir uma VM exclui a VM e os recursos anexados. No entanto, ao excluir uma VM usando a gcloud CLI, é possível especificar a preservação dos discos de inicialização anexados, discos sem inicialização ou ambos, independentemente das configurações de exclusão automática dos discos.
Para excluir uma ou mais VMs localizadas na mesma zona e, ao mesmo tempo, preservar os volumes do Persistent Disk anexados, use o comando gcloud compute instances delete
com a flag --keep-disks
.
gcloud compute instances delete VM_NAMES \
--keep-disks=KEEP_DISK_TYPE \
--zone=ZONE
Substitua:
VM_NAMES
: uma lista separada por espaços em branco de nomes de VMs que estão localizadas na mesma zona, por exemplo,vm-01 vm-02 vm-03
.KEEP_DISK_TYPE
: os tipos de volumes do Persistent Disk anexados que serão preservados. Especifique um dos seguintes valores:Para preservar todos os tipos de discos:
all
.Para preservar apenas os discos de inicialização:
boot
.Para preservar apenas discos sem inicialização:
data
.
ZONE
: a zona onde as VMs estão localizadas.
A seguir
Saiba mais sobre o ciclo de vida da VM.
Saiba mais sobre os custos gerados por VMs interrompidas.
Saiba como limitar o ambiente de execução de uma VM.