Você pode desanexar 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 montá-los em outra instância de VM sem excluir a instância original. Além disso, você pode substituir os discos de inicialização de uma instância em vez de recriar toda a instância da VM.
Se uma instância de VM não tiver um disco de inicialização, a tentativa de iniciar a instância gerará um erro. No entanto, você ainda pode editar outras propriedades da instância.
Antes de começar
- Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
-
compute.instances.detachDisk
na instância -
compute.instances.attachDisk
na instância - Você pode anexar ou desconectar um disco de inicialização somente de uma instância de VM interrompida .
- Você pode anexar apenas um disco de inicialização por instância de VM.
- Se estiver usando a CLI ou REST gcloud, você poderá anexar apenas discos de inicialização existentes a uma instância de VM.
- Acesse a página de instâncias de VM.
- Se solicitado, selecione seu projeto e clique em Continuar .
- Clique na instância da qual deseja desanexar o disco de inicialização.
- Na parte superior da página, clique em Parar .
- Na parte superior da página, clique em Editar .
- Role para baixo até a seção Disco de inicialização e clique no X ao lado do disco de inicialização que você deseja desconectar.
- Clique em Salvar .
-
INSTANCE_NAME
: o nome da instância. -
DISK_NAME
: o nome do disco a ser desanexado. O nome do disco geralmente é igual ao nome da instância. -
PROJECT_ID
: o ID do seu projeto. -
INSTANCE_NAME
: o nome da instância. -
ZONE
: a zona onde suas instâncias estão localizadas. -
DISK_NAME
: o nome do disco a ser desanexado. O nome do disco geralmente é igual ao nome da instância. - Acesse a página de instâncias de VM.
- Se solicitado, selecione seu projeto e clique em Continuar .
- Clique na instância à qual deseja anexar o disco de inicialização.
- Se a instância de VM ainda não estiver interrompida, clique em Parar na parte superior da página.
- Clique em Editar na parte superior da página.
- Role para baixo até a seção Disco de inicialização .
- Clique em Adicionar item .
- Selecione um disco de inicialização no menu suspenso.
- Clique em Salvar .
-
INSTANCE_NAME
: o nome da instância. -
DISK_NAME
: o nome do disco a ser anexado. O nome do disco pode ser igual ao nome da instância. -
PROJECT_ID
: o ID do seu projeto. -
INSTANCE_NAME
: o nome da instância à qual você está anexando o novo disco permanente. -
ZONE
: a zona onde sua instância e seu novo disco estão localizados. -
DISK_NAME
: o nome do novo disco. - Acesse a página de instâncias de VM.
- Se solicitado, selecione seu projeto e clique em Continuar .
- Clique na instância à qual deseja anexar o disco de inicialização.
- Se a instância de VM ainda não estiver interrompida, clique em Parar na parte superior da página.
- Clique em Editar na parte superior da página.
- Role para baixo até a seção Disco de inicialização .
- Clique no X próximo ao disco de inicialização atual.
- Clique em Adicionar item .
- Selecione um disco de inicialização no menu suspenso.
- Clique em Salvar .
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Permissões necessárias para esta tarefa
Para executar esta tarefa, você deve ter as seguintes permissões :
Restrições
Desanexe um disco de inicialização
Antes de desanexar o disco de inicialização da instância de VM, você deve interromper a instância . Você não precisa desmontar o disco.
Console
gcloud
Use o comando
gcloud compute instances detach-disk
para desanexar o disco de inicialização da instância:gcloud compute instances detach-disk INSTANCE_NAME \ --disk=DISK_NAME
Substitua o seguinte:
DESCANSAR
Construa uma solicitação
POST
para desanexar o disco:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/detachDisk?deviceName=DISK_NAME
Substitua o seguinte:
Reconecte um disco de inicialização
Qualquer disco pode ser reanexado como disco de inicialização a uma instância, desde que a instância ainda não tenha um disco de inicialização anexado e que o disco de inicialização esteja na mesma zona que a instância de VM. Se você personalizar um disco de inicialização, deverá garantir que o disco de inicialização seja inicializado corretamente após ser conectado.
Tanto o disco existente quanto o novo disco devem ser compatíveis com UEFI ou não. Para criar um disco compatível com UEFI, use o comando
gcloud compute disk create
com o sinalizador--guest-os-features
definido comoUEFI_COMPATIBLE
.Console
gcloud
Use o comando
gcloud compute instances attach-disk
para anexar ou reconectar um disco de inicialização a uma instância de VM. Incluir o--boot
sinalizador para indicar que o disco é usado como disco de inicialização da instância. Se esse sinalizador estiver ausente, o disco será anexado como um disco de dados que não é de inicialização.gcloud compute instances attach-disk INSTANCE_NAME \ --disk=DISK_NAME \ --boot
Substitua o seguinte:
DESCANSAR
Construa uma solicitação
POST
para anexar o disco. Inclua o parâmetro opcional"boot": true
para indicar que este disco é o disco de inicialização. Se este parâmetro estiver ausente, o disco será anexado como um disco de dados que não é 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 o seguinte:
Depois de anexar o disco à instância de VM, reinicie a instância .
Atualizar um disco de inicialização para uma instância
Só é possível usar o console do Google Cloud para atualizar o disco de inicialização de uma VM em uma única etapa. Especificamente, você pode desanexar um disco de inicialização existente e anexar um novo disco de inicialização como uma ação.
Este recurso não está disponível por meio da CLI gcloud ou REST.
O console do Google Cloud desanexa o disco de inicialização existente e anexa o novo disco de inicialização especificado. Quando esse processo for concluído, reinicie a instância de VM .
O que vem 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-04-21 UTC.
-