Como desconectar e reconectar discos de inicialização
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
É 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:
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 como UEFI_COMPATIBLE.
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 stopParar
para interromper a VM. Se não houver uma opção Parar, clique em
more_vertMais ações >stopParar.
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 --boot
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.
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.
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.
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 stopParar
para interromper a VM. Se não houver uma opção Parar, clique em
more_vertMais ações >stopParar.
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-19 UTC."],[[["\u003cp\u003eYou can detach and attach boot disks to VM instances, which is useful for repairing boot disks or replacing them without recreating the entire VM.\u003c/p\u003e\n"],["\u003cp\u003eDetaching 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.\u003c/p\u003e\n"],["\u003cp\u003eTo detach a boot disk, you can use the Google Cloud console, \u003ccode\u003egcloud\u003c/code\u003e CLI, or REST API, and the process involves stopping the instance, and then detaching the disk.\u003c/p\u003e\n"],["\u003cp\u003eTo attach a boot disk, ensure the disk and instance are in the same zone, and utilize the Google Cloud console, \u003ccode\u003egcloud\u003c/code\u003e CLI, or REST API, making sure to specify that it is the boot disk when using the CLI or API.\u003c/p\u003e\n"],["\u003cp\u003eThe 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 \u003ccode\u003egcloud\u003c/code\u003e or REST.\u003c/p\u003e\n"]]],[],null,["*** ** * ** ***\n\nYou can detach boot disks from your VM instance and attach new boot disks.\nThis feature simplifies the process of repairing boot disks by letting you\nmount them to another VM instance without deleting your original instance.\nAdditionally, you can replace the boot disks for an instance rather than having\nto recreate the entire VM instance.\n\nIf a VM instance does not have a boot disk, attempting to start\nthe instance generates an error. However, you can still edit other instance\nproperties.\n\nBefore you begin\n\n- If you haven't already, set up [authentication](/compute/docs/authentication). Authentication verifies your identity for access to Google Cloud services and APIs. To run code or samples from a local development environment, you can authenticate to Compute Engine by selecting one of the following options:\n\n Select the tab for how you plan to use the samples on this page: \n\n Console\n\n\n When you use the Google Cloud console to access Google Cloud services and\n APIs, you don't need to set up authentication.\n\n gcloud\n 1.\n [Install](/sdk/docs/install) the Google Cloud CLI.\n\n After installation,\n [initialize](/sdk/docs/initializing) the Google Cloud CLI by running the following command:\n\n ```bash\n gcloud init\n ```\n\n\n If you're using an external identity provider (IdP), you must first\n [sign in to the gcloud CLI with your federated identity](/iam/docs/workforce-log-in-gcloud).\n | **Note:** If you installed the gcloud CLI previously, make sure you have the latest version by running `gcloud components update`.\n 2. [Set a default region and zone](/compute/docs/gcloud-compute#set_default_zone_and_region_in_your_local_client).\n\n REST\n\n\n To use the REST API samples on this page in a local development environment, you use the\n credentials you provide to the gcloud CLI.\n 1. [Install](/sdk/docs/install) the Google Cloud CLI. After installation, [initialize](/sdk/docs/initializing) the Google Cloud CLI by running the following command: \n\n ```bash\n gcloud init\n ```\n 2. If you're using an external identity provider (IdP), you must first [sign in to the gcloud CLI with your federated identity](/iam/docs/workforce-log-in-gcloud).\n\n\n For more information, see\n [Authenticate for using REST](/docs/authentication/rest)\n in the Google Cloud authentication documentation.\n\nPermissions required for this task\n\nTo perform this task, you must have the following [permissions](/iam/docs/overview#permissions):\n\n- `compute.instances.detachDisk` on the instance\n- `compute.instances.attachDisk` on the instance\n\nRestrictions\n\n- You can attach or detach a boot disk only from a [stopped VM instance](/compute/docs/instances/stop-start-instance).\n- You can attach only one boot disk per VM instance.\n- If using the gcloud CLI or REST, you can attach only existing boot disks to a VM instance.\n\nDetach a boot disk\n\nBefore detaching the boot disk from the VM instance, you must\n[stop the instance](/compute/docs/instances/stopping-or-deleting-an-instance#stop_an_instance).\nYou don't need to unmount the disk. \n\nConsole\n\n1. Go to the VM instances page. [Go to VM instances](https://console.cloud.google.com/compute/instances)\n\n2. If prompted, select your project and click **Continue**.\n3. Click the instance for which you want to detach the boot disk.\n4. Click stop **Stop** to stop the VM. If there is no **Stop** option, click more_vert **More actions \\\u003e** stop **Stop**.\n5. Click **Edit**.\n6. Scroll down to the **Boot Disk** section and click **X** next to the boot disk that you want to detach.\n7. Click **Save**.\n\ngcloud\n\nUse the\n[`gcloud compute instances detach-disk` command](/sdk/gcloud/reference/compute/instances/detach-disk)\nto detach the boot disk from the instance: \n\n```\ngcloud compute instances detach-disk INSTANCE_NAME \\\n --disk=DISK_NAME\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eINSTANCE_NAME\u003c/var\u003e: the name of the instance.\n- \u003cvar translate=\"no\"\u003eDISK_NAME\u003c/var\u003e: the name of the disk to detach. The disk name is usually the same as the instance name.\n\nREST\n\nConstruct a `POST` request to detach the disk: \n\n```\nPOST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/detachDisk?deviceName=DISK_NAME\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of your project.\n- \u003cvar translate=\"no\"\u003eINSTANCE_NAME\u003c/var\u003e: the name of the instance.\n- \u003cvar translate=\"no\"\u003eZONE\u003c/var\u003e: the zone where your instances is located.\n- \u003cvar translate=\"no\"\u003eDISK_NAME\u003c/var\u003e: the name of the disk to detach. The disk name is usually the same as the instance name.\n\nReattach a boot disk\n\nAny disk can be reattached as a boot disk to an instance as long as the instance\ndoes not already have a boot disk attached and the boot disk is in the same\nzone as the VM instance. If you customize a boot disk, you\nmust ensure that the boot disk boots properly after it is attached.\n\nBoth the existing disk and the new disk must either be UEFI-compatible or not.\nTo create a UEFI-compatible disk, use the [`gcloud compute disk create` command](/sdk/gcloud/reference/compute/disks/create)\nwith the `--guest-os-features` flag set to `UEFI_COMPATIBLE`. \n\nConsole\n\n1. Go to the VM instances page. [Go to VM instances](https://console.cloud.google.com/compute/instances)\n\n2. If prompted, select your project and click **Continue**.\n3. Click the instance for which you want to attach the boot disk.\n4. If the VM is running, click stop **Stop** to stop the VM. If there is no **Stop** option, click more_vert **More actions \\\u003e** stop **Stop**.\n5. Click **Edit**.\n6. Go to the **Boot Disk** section.\n7. Click **Add item**.\n8. Select a boot disk from the drop-down menu.\n9. Click **Save**.\n\ngcloud\n\nUse the\n[`gcloud compute instances attach-disk` command](/sdk/gcloud/reference/compute/instances/attach-disk)\nto attach or reattach a boot disk to a VM instance. Include the `--boot`\nflag to indicate that the disk is used as the boot disk for the instance.\nIf this flag is absent, the disk is attached as a non-boot data disk. \n\n```\ngcloud compute instances attach-disk INSTANCE_NAME \\\n --disk=DISK_NAME \\\n --boot\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eINSTANCE_NAME\u003c/var\u003e: the name of the instance.\n- \u003cvar translate=\"no\"\u003eDISK_NAME\u003c/var\u003e: the name of the disk to attach. The disk name may be the same as the instance name.\n\nREST\n\nConstruct a `POST` request to attach the disk. Include the optional\n`\"boot\": true` parameter to indicate that this disk is the boot disk. If\nthis parameter is absent, the disk is attached as a non-boot data disk. \n\n```\nPOST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk\n{\n \"boot\": true,\n \"source\": \"zones/ZONE/disks/DISK_NAME\"\n}\n```\n\n\u003cbr /\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of your project.\n- \u003cvar translate=\"no\"\u003eINSTANCE_NAME\u003c/var\u003e: the name of the instance to which you're attaching the new Persistent Disk.\n- \u003cvar translate=\"no\"\u003eZONE\u003c/var\u003e: the zone where your instance and new disk are located.\n- \u003cvar translate=\"no\"\u003eDISK_NAME\u003c/var\u003e: the name of the new disk.\n\nAfter you attach the disk to your VM instance,\n[restart the instance](/compute/docs/instances/restarting-an-instance).\n\nUpdate a boot disk for an instance\n\nYou can use only the Google Cloud console to update the boot disk for a VM in\none step. Specifically, you can detach an existing boot disk and attach a new\nboot disk as one action.\n\nThis feature is not available through the gcloud CLI or REST.\n\n1. Go to the VM instances page. [Go to VM instances](https://console.cloud.google.com/compute/instances)\n\n2. If prompted, select your project and click **Continue**.\n3. Click the instance for which you want to attach the boot disk.\n4. If the VM is running, click stop **Stop** to stop the VM. If there is no **Stop** option, click more_vert **More actions \\\u003e** stop **Stop**.\n5. Click **Edit** at the top of the page.\n6. Scroll down to the **Boot Disk** section.\n7. Click **X** next to the current boot disk.\n8. Click **Add item**.\n9. Select a boot disk from the drop-down menu.\n10. Click **Save**.\n\nThe Google Cloud console proceeds to detach your existing boot disk and attach\nthe new boot disk that you specified. When this process is complete,\n[restart the VM instance](/compute/docs/instances/restarting-an-instance).\n\nWhat's next?\n\n- [Create a new disk from a snapshot](/compute/docs/disks/restore-and-delete-snapshots#restoresnapshotlargersize)\n- [Transfer files to VM instances](/compute/docs/instances/transfer-files)"]]