É 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 Trusted Cloud by S3NS .
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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Instale a Google Cloud CLI e faça login nela com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud init
- 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 Google Cloud CLI e faça login nela com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud init
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Trusted 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 Trusted 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 Trusted 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-08 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-08 UTC."],[[["You can detach and attach boot disks to VM instances, which is useful for repairing boot disks or replacing them without recreating the entire VM."],["Detaching or attaching a boot disk can only be done when the VM instance is stopped, and each VM can only have one boot disk at a time."],["To detach a boot disk, you can use the Google Cloud console, `gcloud` CLI, or REST API, and the process involves stopping the instance, and then detaching the disk."],["To attach a boot disk, ensure the disk and instance are in the same zone, and utilize the Google Cloud console, `gcloud` CLI, or REST API, making sure to specify that it is the boot disk when using the CLI or API."],["The Google Cloud console allows for updating a boot disk in one step by detaching an existing one and attaching a new one, a feature not supported by `gcloud` or REST."]]],[]] -