É possível remover os discos de inicialização da sua instância de VM e anexar novos discos de inicialização. Esse recurso simplifica o processo de reparo de discos de inicialização, permitindo que você os monte em outra instância de VM sem excluir a instância original. Além disso, é possível substituir os discos de inicialização de uma instância em vez de precisar recriá-la.
Se uma instância de VM não tiver um disco de inicialização, ocorrerá um erro caso você tente iniciá-la. No entanto, ainda é possível editar outras propriedades da instância.
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 selecionando uma das seguintes opções:
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
-
Instale a CLI do Google Cloud. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud init
Se você estiver usando um provedor de identidade externo (IdP), primeiro faça login na CLI gcloud com sua identidade federada.
- Set a default region and zone.
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 CLI do Google Cloud. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud init
Se você estiver usando um provedor de identidade externo (IdP), primeiro faça login na CLI gcloud com sua identidade federada.
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud .
Permissões exigidas para a tarefa
Para executar esta tarefa, é preciso ter a permissão a seguir:
compute.instances.detachDisk
na instânciacompute.instances.attachDisk
na instância
Restrições
- É possível anexar ou remover um disco de inicialização somente de uma instância de VM interrompida.
- É possível anexar apenas um disco de inicialização por instância de VM.
- Se estiver usando a CLI gcloud ou a REST, será possível anexar apenas os discos de inicialização atuais a uma instância de VM.
Remover um disco de inicialização
Antes de desanexar o disco de inicialização da instância, interrompa a instância. Não é preciso desconectar o disco.
Console
- Acesse a página "Instâncias de VM".
- Se solicitado, selecione o projeto e clique em Continuar.
- Clique na instância de que você quer remover o disco de inicialização.
- Clique em Parar para interromper a VM. Se não houver uma opção Parar, clique em Mais ações > Parar.
- Clique em Editar.
- Role a tela para baixo até a seção Disco de inicialização e clique em X ao lado do disco de inicialização que você quer remover.
- Clique em Salvar.
gcloud
Use o
gcloud compute instances detach-disk
comando para remover o disco de inicialização da instância:gcloud compute instances detach-disk INSTANCE_NAME \ --disk=DISK_NAME
Substitua:
INSTANCE_NAME
: o nome da instância.DISK_NAME
: o nome do disco que você quer remover. Geralmente, o nome do disco é igual ao da instância.
REST
Crie uma solicitação
POST
para remover o disco:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/detachDisk?deviceName=DISK_NAME
Substitua:
PROJECT_ID
: ID do projeto.INSTANCE_NAME
: o nome da instância.ZONE
: a zona em que as instâncias estão localizadas.DISK_NAME
: o nome do disco que você quer remover. Geralmente, o nome do disco é igual ao da instância.
Reanexar um disco de inicialização
Qualquer disco pode ser reanexado como um disco de inicialização a uma instância, desde que ela ainda não tenha um disco como esse anexado e ele esteja na mesma zona da instância da VM. Caso personalize um disco de inicialização, você precisará verificar se ele é inicializado corretamente depois de anexado.
O disco existente e o novo disco precisam ser compatíveis com UEFI ou não. Para criar um disco compatível com UEFI, use o comando
gcloud compute disk create
com a sinalização--guest-os-features
definida comoUEFI_COMPATIBLE
.Console
- Acesse a página "Instâncias de VM".
- Se solicitado, selecione o projeto e clique em Continuar.
- Clique na instância de que você quer anexar o disco de inicialização.
- Se a VM estiver em execução, clique em Parar para interromper a VM. Se não houver uma opção Parar, clique em Mais ações > Parar.
- Clique em Editar.
- Acesse a seção Disco de inicialização.
- Clique em Adicionar item.
- Selecione um disco de inicialização no menu suspenso.
- Clique em Salvar.
gcloud
Use o comando
gcloud compute instances attach-disk
para anexar ou reanexar um disco de inicialização a uma instância de VM. Inclua a sinalização para indicar que o disco está sendo usado como o disco de inicialização da instância. Se essa sinalização estiver ausente, o disco será anexado como um disco de dados que não seja de inicialização.--boot
gcloud compute instances attach-disk INSTANCE_NAME \ --disk=DISK_NAME \ --boot
Substitua:
INSTANCE_NAME
: o nome da instância.DISK_NAME
: o nome do disco que você quer anexar. Ele pode ser igual ao nome da instância;
REST
Crie uma solicitação
POST
para anexar o disco. Inclua o parâmetro opcional"boot": true
para indicar que esse disco é o de inicialização. Se esse parâmetro estiver ausente, o disco será anexado como um disco de dados que não seja de inicialização.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk { "boot": true, "source": "zones/ZONE/disks/DISK_NAME" }
Substitua:
PROJECT_ID
: ID do projeto.INSTANCE_NAME
: o nome da instância a que você está anexando o novo disco permanente.ZONE
: a zona em que a instância e o novo disco estão localizados.DISK_NAME
: o nome do novo disco.
Depois de anexar o disco à instância de VM, reinicie a instância.
Atualizar um disco de inicialização de uma instância
Só é possível usar o Google Cloud console para atualizar o disco de inicialização para uma VM em uma etapa. Especificamente, é possível desanexar um disco de inicialização atual e anexar um novo com apenas uma ação.
Este recurso não está disponível pela CLI gcloud ou REST.
- Acesse a página "Instâncias de VM".
- Se solicitado, selecione o projeto e clique em Continuar.
- Clique na instância de que você quer anexar o disco de inicialização.
- Se a VM estiver em execução, clique em Parar para interromper a VM. Se não houver uma opção Parar, clique em Mais ações > Parar.
- Clique em Editar no topo da página.
- Role para baixo até a seção Disco de inicialização.
- Clique em X ao lado do disco de inicialização atual.
- Clique em Adicionar item.
- Selecione um disco de inicialização no menu suspenso.
- Clique em Salvar.
O console Google Cloud continua para remover o disco de inicialização atual e anexar o novo disco que você especificou. Quando esse processo estiver concluído, reinicie a instância da VM.
A seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-19 UTC.
-