Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Anda dapat melepaskan boot disk dari instance VM dan memasang boot disk baru.
Fitur ini menyederhanakan proses perbaikan boot disk dengan memungkinkan Anda
memasangnya ke instance VM lain tanpa menghapus instance asli Anda.
Selain itu, Anda dapat mengganti boot disk untuk suatu instance daripada harus
membuat ulang seluruh instance VM.
Jika instance VM tidak memiliki boot disk, upaya untuk memulai
instance akan menghasilkan error. Namun, Anda tetap dapat mengedit properti instance lainnya.
Sebelum memulai
Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah
proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Google Cloud layanan dan API.
Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke
Compute Engine dengan memilih salah satu opsi berikut:
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
Menginstal Google Cloud CLI.
Setelah penginstalan,
lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
DISK_NAME: nama disk yang akan dilepas.
Nama disk biasanya sama dengan nama instance.
REST
Buat permintaan POST untuk melepaskan disk:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/detachDisk?deviceName=DISK_NAME
Ganti kode berikut:
PROJECT_ID: ID project Anda.
INSTANCE_NAME: nama instance.
ZONE: zona tempat instance Anda berada.
DISK_NAME: nama disk yang akan dilepas.
Nama disk biasanya sama dengan nama instance.
Memasang kembali boot disk
Setiap disk dapat dipasang kembali sebagai boot disk ke instance selama instance tersebut belum memasang boot disk dan boot disk berada di zona yang sama dengan instance VM. Jika menyesuaikan boot disk, Anda
harus memastikan bahwa boot disk akan melakukan booting dengan benar setelah dipasang.
Disk yang ada dan disk baru harus kompatibel dengan UEFI atau tidak.
Untuk membuat disk yang kompatibel dengan UEFI, gunakan perintah gcloud compute disk create
dengan flag --guest-os-features yang ditetapkan ke UEFI_COMPATIBLE.
Jika diminta, pilih project Anda lalu klik Continue.
Klik instance tempat Anda ingin memasang boot disk.
Jika VM berjalan, klik stopHentikan
untuk menghentikan VM. Jika tidak ada opsi Hentikan, klik
more_vertTindakan lainnya >stopHentikan.
Klik Edit.
Buka bagian Boot Disk.
Klik Tambahkan item.
Pilih boot disk dari menu drop-down.
Klik Save.
gcloud
Gunakan perintah gcloud compute instances attach-disk untuk memasang atau memasang kembali boot disk ke instance VM. Sertakan flag --boot
untuk menunjukkan bahwa disk digunakan sebagai boot disk untuk instance.
Jika flag ini tidak ada, disk akan dipasang sebagai disk data non-booting.
DISK_NAME: nama disk yang akan dipasang.
Nama disk mungkin sama dengan nama instance.
REST
Buat permintaan POST untuk melampirkan disk. Sertakan parameter
"boot": true opsional untuk menunjukkan bahwa disk ini adalah boot disk. Jika
parameter ini tidak ada, disk akan dipasang sebagai disk data non-booting.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk
{
"boot": true,
"source": "zones/ZONE/disks/DISK_NAME"
}
Ganti kode berikut:
PROJECT_ID: ID project Anda.
INSTANCE_NAME: nama instance tempat Anda memasang Persistent Disk baru.
ZONE: zona tempat instance dan disk baru
Anda berada.
Anda hanya dapat menggunakan konsol Google Cloud untuk mengupdate boot disk untuk VM dalam
satu langkah. Secara khusus, Anda dapat melepas boot disk yang ada dan memasang boot disk
baru sebagai satu tindakan.
Fitur ini tidak tersedia melalui gcloud CLI atau REST.
Jika diminta, pilih project Anda lalu klik Continue.
Klik instance tempat Anda ingin memasang boot disk.
Jika VM berjalan, klik stopHentikan
untuk menghentikan VM. Jika tidak ada opsi Hentikan, klik
more_vertTindakan lainnya >stopHentikan.
Klik Edit di bagian atas halaman.
Scroll ke bawah ke bagian Boot disk.
Klik X di samping boot disk saat ini.
Klik Add item.
Pilih boot disk dari menu drop-down.
Klik Simpan.
Konsol Google Cloud melanjutkan proses melepaskan boot disk yang ada dan memasang boot disk baru yang Anda tentukan. Setelah proses ini selesai, mulai ulang instance VM.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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,["# Detaching and reattaching boot disks\n\n*** ** * ** ***\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\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\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\n#### Permissions 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\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------------------\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\n### Console\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\n### gcloud\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\n### REST\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--------------------\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\n### Console\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\n### gcloud\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\n### REST\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----------------------------------\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\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)"]]