建立及管理區域磁碟

控制台

1. 前往 Google Cloud 控制台的「Disks」(磁碟) 頁面。

   前往「Disks」(磁碟) 頁面

2. 選取所需專案。

3. 按一下 [Create Disk] (建立磁碟)。

4. 指定磁碟的「Name」(名稱)。

5. 在「位置」中，選擇「地區」。

6. 選取「區域」和「可用區」。建立執行個體時，您必須選取相同的區域。

7. 在相同區域中選取「副本區域」。 請記下您選取的區域，因為您必須將磁碟連接到其中一個區域內的執行個體。

8. 在「Disk source type」(磁碟來源類型) 下方，選擇磁碟的資料來源：

   • 如要建立空白磁碟，請選取「空白磁碟」。
   • 如要從映像檔建立磁碟，請按照下列步驟操作：
     1. 選取「圖片」。
     2. 在「Source image」(來源映像檔) 底下，選擇磁碟的來源映像檔。
   • 如要從現有快照建立磁碟，請按照下列步驟操作：
     1. 視來源快照分別為標準快照、即時快照或封存快照，選取「快照」、「即時快照」或「封存快照」。
     2. 在「Source snapshot」(來源快照) 底下，從清單中選取來源快照或即時快照。系統只會列出所選位置的快照。
   • 如要從機器映像檔 (搶先版) 中的特定磁碟建立磁碟：
     1. 選取「機器映像檔」。
     2. 在「來源機器映像檔」下拉式選單中，選取要使用的機器映像檔。
     3. 在「Source disk」(來源磁碟) 下拉式選單中，選取所選機器映像檔中特定磁碟的裝置名稱，做為新磁碟的來源。
     4. 如果所選機器映像檔受到客戶提供的加密金鑰 (CSEK) 保護 (已淘汰)，系統會顯示「Encryption」(加密) 專區。在提供的欄位中輸入必要的解密金鑰。
     5. 視需要設定其他磁碟屬性，例如「Name」(名稱)、「Type」(類型)、「Size」(大小) 和「Deletion」(刪除) 規則。

9. 在「磁碟設定」下方，選擇「磁碟類型」和「大小」。對於 Hyperdisk Balanced High Availability 磁碟區，您也可以變更預設的「佈建 IOPS」和「佈建輸送量」設定。

10. 選用：如果是 Hyperdisk Balanced High Availability 磁碟區，您可以建立處於多重寫入模式的磁碟，啟用將磁碟連接至多個執行個體的功能。在「存取模式」中，選取「多個 VM 讀寫」。

11. 按一下 [Create] (建立) 來結束磁碟建立作業。

gcloud

使用 compute disks create 指令建立地區磁碟。

您可以建立空白磁碟，也可以透過映像檔 (預覽版)、即時快照或標準快照建立磁碟。

gcloud compute disks create DISK_NAME \
 --size=DISK_SIZE \
 --type=DISK_TYPE \
 --region=REGION \
 --replica-zones=ZONE1,ZONE2 \
 --access-mode=DISK_ACCESS_MODE

gcloud compute disks create DISK_NAME \
  --size=DISK_SIZE \
  --type=DISK_TYPE \
  --region=REGION \
  --replica-zones=ZONE1,ZONE2 \
  --access-mode=DISK_ACCESS_MODE \
  --source-snapshot=SNAPSHOT_NAME \
  [ --source-snapshot-region=SOURCE_REGION ]

 gcloud compute disks create DISK_NAME \
    --source-instant-snapshot=INSTANT_SNAPSHOT_NAME

 gcloud beta compute disks create DISK_NAME \
    --size=DISK_SIZE \
    --type=DISK_TYPE \
    --region=REGION \
    --replica-zones=ZONE1,ZONE2 \
    --access-mode=DISK_ACCESS_MODE \
    --image=IMAGE_NAME

 gcloud beta compute disks create DISK_NAME \
    --size=DISK_SIZE \
    --type=DISK_TYPE  --region=REGION \
    --replica-zones=ZONE1,ZONE2 \
    --image-family=IMAGE_FAMILY_NAME

Terraform

如要建立區域性 Persistent Disk 或 Hyperdisk Balanced High Availability 磁碟區，請使用 google_compute_region_disk 資源。

如要指定磁碟類型，請將 type 引數設為下列清單中的對應值。

• Hyperdisk Balanced High Availability：hyperdisk-balanced-high-availability
• SSD 永久磁碟：pd-ssd
• 平衡型永久磁碟：pd-balanced
• 標準永久磁碟：pd-standard

如要從映像檔建立磁碟 (Preview)，請將下列範例中的 snapshot 引數替換為 image 引數。

下列範例會從快照建立地區磁碟。

resource "google_compute_region_disk" "regiondisk" {
  name                      = "region-disk-name"
  snapshot                  = google_compute_snapshot.snapdisk.id
  type                      = "pd-ssd"
  region                    = "us-central1"
  physical_block_size_bytes = 4096
  size                      = 11

  replica_zones = ["us-central1-a", "us-central1-f"]
}

如要瞭解如何套用或移除 Terraform 設定，請參閱「基本 Terraform 指令」。

REST

如要建立區域永久磁碟或 Hyperdisk Balanced High Availability 磁碟區，請向 compute.regionDisks.insert 方法提出 POST 要求。

您可以建立空白磁碟，也可以從映像檔 (預覽版) 或標準/即時快照建立磁碟。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/disks
{
 
   "name": "DISK_NAME",
   "region": "projects/PROJECT_ID/regions/REGION",
   "replicaZones": [
   "projects/PROJECT_ID/zones/ZONE1",
   "projects/PROJECT_ID/zones/ZONE2"
   ],
   "sizeGb": "DISK_SIZE",
   "type": "projects/PROJECT_ID/regions/REGION/diskTypes/DISK_TYPE",
   "accessMode": "DISK_ACCESS_MODE"
}

POST https://compute.googleapis.com/compute/v1/projects/ PROJECT_ID/regions/REGION/disks
{
 "name": "DISK_NAME",
 "sourceInstantSnapshot": "projects/PROJECT/regions/SOURCE_REGION/instantSnapshots/ SOURCE_INSTANT_SNAPSHOT_NAME"
}

控制台

1. 如要將磁碟連結至執行個體，請前往「VM instances」(VM 執行個體) 頁面。

   前往 VM 執行個體

2. 在「名稱」欄中，按一下執行個體的名稱。

3. 按一下「Edit」(編輯)edit。

4. 按一下「+Attach existing disk」(+ 連接現有的磁碟)。

5. 選擇先前建立的地區磁碟，並新增至執行個體。

6. 如果看到警告訊息，指出所選磁碟已連結至其他執行個體，請選取「強制連結磁碟」方塊，強制將磁碟連結至您正在編輯的執行個體。

   如要瞭解強制連結區域磁碟的使用案例，請參閱「區域磁碟容錯移轉」。

7. 選用：如要將 Hyperdisk Balanced High Availability 磁碟連接至多個執行個體，請在「Disk attachment mode」(磁碟連接模式) 選取「Read/write」(讀寫)。

8. 按一下 [儲存]。

9. 在「Edit VM」(編輯 VM) 頁面上，按一下「Save」(儲存)。

gcloud

如要將地區磁碟附加至執行中或已停止的執行個體，請使用 compute instances attach-disk 指令，並將 --disk-scope 旗標設為 regional。

如果以多重寫入模式將 Hyperdisk Balanced High Availability 磁碟連接至多個執行個體，唯一支援的連接模式是 rw，也就是預設的存取模式。您不必加上 --mode 旗標。

gcloud compute instances attach-disk INSTANCE_NAME \
    --disk=DISK_NAME \
    --disk-scope=regional \
    --device-name=DEVICE_NAME

更改下列內容：

• INSTANCE_NAME：要新增地區磁碟的執行個體名稱
• DISK_NAME：要連接至執行個體的新磁碟名稱
• DEVICE_NAME：選用：客體 OS 用於建立符號連結的名稱，有助於在 OS 層級識別磁碟。

Terraform

如要將地區永久磁碟或 Hyperdisk Balanced High Availability 磁碟區連接至執行個體，可以使用 google_compute_attached_disk 資源。

resource "google_compute_instance" "test_node" {
  name         = "test-node"
  machine_type = "f1-micro"
  zone         = "us-west1-a"

  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-13"
    }
  }
  attached_disk {
    source      = google_compute_disk.default.id
    device_name = google_compute_disk.default.name
  }

  network_interface {
    network = "default"
    access_config {
      # Ephemeral IP
    }
  }

  # Ignore changes for persistent disk attachments
  lifecycle {
    ignore_changes = [attached_disk]
  }


}

如要瞭解如何套用或移除 Terraform 設定，請參閱「基本 Terraform 指令」。

REST

如要將區域磁碟連接至執行中或已停止的執行個體，請對 compute.instances.attachDisk 方法建構 POST 要求，並加入您建立的區域磁碟網址。

如果以多重寫入模式將 Hyperdisk Balanced High Availability 磁碟連接至多個執行個體，唯一支援的連接模式是 READ-WRITE，也就是預設的存取模式。你不需要加入 mode 屬性。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk
 {
  "source": "/projects/PROJECT_ID/regions/REGION/disks/DISK_NAME",
  "deviceName": DEVICE_NAME
 }

更改下列內容：

• PROJECT_ID：專案 ID
• ZONE：執行個體的位置
• INSTANCE_NAME：要新增區域磁碟的執行個體名稱
• REGION：區域磁碟所在的區域
• DISK_NAME：區域磁碟的名稱 (如 Google Cloud 控制台中所示)。
• DEVICE_NAME：選用：客體 OS 用於建立符號連結的名稱，有助於在 OS 層級識別磁碟。

控制台

1. 前往 Google Cloud 控制台的「Create an instance」(建立執行個體) 頁面。

   前往「建立執行個體」

   如果出現系統提示，請選取您的專案，然後按一下 [Continue] (繼續)。

   「建立執行個體」頁面隨即顯示，並顯示「機器設定」窗格。

2. 在「機器設定」窗格中，執行下列操作：

   1. 在「Name」(名稱) 欄位中，指定執行個體的名稱。詳情請參閱「資源命名慣例」。

   2. 選用：在「Zone」(區域) 欄位中，選取這個執行個體的區域。

      預設選取項為「任何」。如未變更這項預設選取項目，Google 會根據機型和可用性自動為您選擇可用區。

   3. 從下列選項中，為執行個體選取機器家族：

      • 一般用途
      • 運算最佳化
      • 記憶體最佳化
      • 儲存空間最佳化
      • 網路最佳化
      • GPU
      • TPU

      Google Cloud 主控台隨即會顯示所選機器家族適用的機器系列。

   4. 在「系列」欄中，選取執行個體的機器系列。

      如果您在上一個步驟中選取「GPU」做為機器系列，請選取所需的 GPU 類型。系統會根據所選的 GPU 類型，自動選取機器系列。

   5. 在「Machine type」(機型) 部分中，選取執行個體的機型。

3. 在導覽選單中，按一下「OS and storage」(OS 和儲存空間)。在隨即顯示的「作業系統和儲存空間」窗格中，完成下列步驟。

   如要進一步瞭解新增磁碟時可設定的參數，請參閱「關於永久磁碟」和「關於 Google Cloud Hyperdisk」。

   1. 如要開始設定開機磁碟，請按一下「變更」。系統會顯示「開機磁碟」窗格，並顯示「公開映像檔」分頁。

   2. 請使用下列其中一種方式，設定開機磁碟的資料來源：

      • 如要選擇公開映像檔做為開機磁碟的資料來源，請在「Public images」(公開映像檔) 分頁中指定下列項目：
        1. 在「Operating system」(作業系統) 清單中，選取作業系統類型。
        2. 在「Version」清單中，選取作業系統版本。
        3. 在「Boot disk type」(開機磁碟類型) 清單中，選取開機磁碟類型。
        4. 在「Size (GB)」(大小 (GB)) 欄位中，指定開機磁碟的大小。
      • 如要選擇自訂映像檔做為開機磁碟的資料來源，請按一下「自訂映像檔」，然後在隨即顯示的「自訂映像檔」分頁中，指定下列項目：
        1. 如要選取圖片專案，請按一下「變更」，然後選取含有圖片的專案。
        2. 在「圖片」清單中，選取要匯入的圖片。
        3. 在「Boot disk type」(開機磁碟類型) 清單中，選取開機磁碟類型。
        4. 在「Size (GB)」(大小 (GB)) 欄位中，指定開機磁碟的大小。
      • 如要選擇標準快照做為開機磁碟的資料來源，請按一下「快照」，然後在隨即顯示的「快照」分頁中，指定下列項目：
        1. 在「Snapshot」(快照) 清單中選取快照。
        2. 在「Boot disk type」(開機磁碟類型) 清單中，選取開機磁碟類型。
        3. 在「Size (GB)」(大小 (GB)) 欄位中，指定開機磁碟的大小。
      • 如要選擇封存快照做為開機磁碟的資料來源，請按一下「封存快照」，然後在隨即顯示的「封存快照」分頁中，指定下列項目：
        1. 在「封存快照」清單中，選取封存快照。
        2. 在「Boot disk type」(開機磁碟類型) 清單中，選取開機磁碟類型。
        3. 在「Size (GB)」(大小 (GB)) 欄位中，指定開機磁碟的大小。
      • 如要選擇現有磁碟做為開機磁碟，請按一下「現有磁碟」。接著，在隨即顯示的「現有磁碟」分頁中，選取「磁碟」清單中的現有磁碟。這個選項會使用現有磁碟做為開機磁碟，不會建立新磁碟。

   3. 選用：如需進階設定選項，請展開「Show advanced configurations」(顯示進階設定) 部分。expand_more

   4. 如要確認開機磁碟選項並返回「作業系統和儲存空間」窗格，請按一下「選取」。

   5. 選用：如要瞭解如何將非開機磁碟連結至執行個體，請參閱「建立含有額外非開機磁碟的執行個體」。

4. 如果您未選擇現有的開機磁碟，請按照下列步驟將其設定為區域磁碟：

   1. 在導覽選單中，按一下「資料保護」。在隨即顯示的「資料保護」窗格中，執行下列操作：

      1. 如要將執行個體的所有新磁碟設為使用同步磁碟複製 (區域性永久磁碟或 Hyperdisk Balanced High Availability)，請選取「區域性磁碟」核取方塊。

      2. (預設為無動作)。取消勾選「排除開機磁碟」核取方塊。

5. 視需要指定其他設定選項。詳情請參閱「建立執行個體時的設定選項」。

6. 如要建立並啟動執行個體，請按一下「建立」。

gcloud

使用 gcloud compute instances create 指令建立執行個體，並使用 --create-disk 旗標指定區域磁碟。指定磁碟參數時，^:^ 字元會指定參數間的分隔字元為半形冒號 (:)。這樣一來，您就能在指定 replica-zones 參數時使用半形逗號 (,)。

• 如要建立執行個體，並從公開映像檔或自訂映像檔建立執行個體的區域開機磁碟 (預先發布版)：

  gcloud compute instances create PRIMARY_INSTANCE_NAME \
  --zone=ZONE --project=PROJECT_ID \
  --create-disk=^:^name=REGIONAL_DISK_NAME:boot=true:type=DISK_TYPE:replica-zones=ZONE,REMOTE_ZONE:[IMAGE_NAME_OR_FAMILY]
  

  更改下列內容：

  • PRIMARY_INSTANCE_NAME：執行個體的名稱
  • ZONE：要在哪個可用區建立執行個體
  • PROJECT_ID：要在其中建立執行個體的專案名稱
  • REGIONAL_DISK_NAME：地區磁碟的名稱
  • DISK_TYPE：要建立的磁碟類型，例如 hyperdisk-balanced-high-availability。 如果使用永久磁碟，則必須在 --create-disk 旗標中指定 scope=regional，才能建立地區永久磁碟。
  • REMOTE_ZONE：地區磁碟的替代可用區

  • IMAGE_NAME_OR_FAMILY：要使用的映像檔名稱或系列。

  • 如要使用特定版本的公開或自訂映像檔，請指定 image=<var>IMAGE_NAME</var>，其中 <var>IMAGE_NAME</var> 是映像檔名稱。例如 image=debian-13-trixie-v20260902 或 image=my-custom-image。

  • 如要使用映像檔系列，請指定 image-family=<var>IMAGE_FAMILY</var>:image-family-scope=global。這樣一來，執行個體就會使用映像檔系列中未淘汰的最新 OS 映像檔。

    舉例來說，如要使用 Debian 13 映像檔系列中的最新版 OS 映像檔，請指定 image-family=debian-13:image-family-scope=global。

• 如要建立執行個體，並從快照建立地區開機磁碟，請按照下列步驟操作：

  gcloud compute instances create PRIMARY_INSTANCE_NAME \
  --zone=ZONE --project=PROJECT_ID \
  --create-disk=^:^name=REGIONAL_DISK_NAME:boot=true:type=DISK_TYPE:source-snapshot=SNAPSHOT_NAME:replica-zones=ZONE,REMOTE_ZONE
  

  使用與上一個指令相同的參數，並將 <var>SNAPSHOT_NAME</var> 替換為開機磁碟的快照名稱，例如 dev-snapshot-may2026。

REST

對 instances.insert 方法建立 POST 要求，並指定 boot: 'true' 和 replicaZones 屬性。如要透過快照建立執行個體，請指定 sourceSnapshot 屬性。如要透過映像檔建立執行個體，請指定 sourceImage 屬性。

• 如要建立執行個體，並從快照建立執行個體的區域開機磁碟，請按照下列步驟操作：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
 "name": "INSTANCE_NAME",
 "disks": [{
    "boot": true,
    "initializeParams": {
       "sourceSnapshot": "global/snapshots/BOOT_SNAPSHOT_NAME",
       "replicaZones": [
           "projects/PROJECT_ID/zones/ZONE",
           "projects/PROJECT_ID/zones/REMOTE_ZONE"
       ],
       "diskType": "projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE"
    }
  }],
 "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ]
}

更改下列內容：

• PROJECT_ID：專案 ID
• ZONE：要建立執行個體的可用區名稱
• INSTANCE_NAME：執行個體的名稱
• BOOT_SNAPSHOT_NAME：開機磁碟快照的名稱
• REMOTE_ZONE：區域磁碟的遠端可用區

• DISK_TYPE：要建立的磁碟類型，例如 hyperdisk-balanced-high-availability、 或 pd-balanced

• 如要從映像檔建立執行個體和地區開機磁碟 (搶先版)：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
 "name": "INSTANCE_NAME",
 "disks": [{
    "boot": true,
    "initializeParams": {
       "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE_NAME",
       "replicaZones": [
           "projects/PROJECT_ID/zones/ZONE",
           "projects/PROJECT_ID/zones/REMOTE_ZONE"
       ],
       "diskType": "projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE"
    }
  }],
 "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ]
}

gcloud

1. 停止執行個體。

   gcloud compute instances stop INSTANCE_NAME  --zone=ZONE
   

2. 從執行個體卸離目前的開機磁碟。

   gcloud compute instances detach-disk INSTANCE_NAME \
    --zone=ZONE --disk=CURRENT_BOOT_DEVICE_NAME
   

3. 將地區開機磁碟連接至執行個體。

   gcloud compute instances attach-disk INSTANCE_NAME  \
    --zone=ZONE  \
    --disk=REGIONAL_DISK_NAME  \
    --disk-scope=regional --force-attach \
    --boot
   

4. 重新啟動執行個體。

   gcloud compute instances start INSTANCE_NAME
   

將先前指令中的變數替換為下列內容：

• INSTANCE_NAME：要連結地區開機磁碟的執行個體名稱
• ZONE：執行個體所在的可用區
• CURRENT_BOOT_DEVICE_NAME：執行個體使用的開機磁碟名稱。這通常與執行個體名稱相同。
• REGIONAL_DISK_NAME：要附加至執行個體做為開機磁碟的區域磁碟名稱

選用：如果因中斷或失敗而無法順利從主要執行個體卸載區域性開機磁碟，請加入 --force-attach 旗標。

REST

1. 停止執行個體。

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop
   

2. 從執行個體卸載目前的開機磁碟。

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/detachDisk?deviceName=CURRENT_BOOT_DEVICE_NAME
   

3. 將地區開機磁碟連接至執行個體。

   對 compute.instances.attachDisk 方法建構 POST 要求，並包含區域開機磁碟的網址：

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk
   {
   "source": "compute/v1/projects/PROJECT_ID/regions/REGION/disks/REGIONAL_DISK_NAME",
   "boot": true
   }

4. 重新啟動執行個體。

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/start
   

將先前指令中的變數替換為下列內容：

• PROJECT_ID：專案 ID
• INSTANCE_NAME：要連結地區磁碟的執行個體名稱
• ZONE：執行個體所在的可用區
• CURRENT_BOOT_DEVICE_NAME：執行個體使用的開機磁碟名稱。這通常與執行個體名稱相同。
• REGION：區域磁碟所在的區域
• REGIONAL_DISK_NAME：要附加至執行個體做為開機磁碟的區域磁碟名稱

選用：如果因為中斷或故障，您無法從原本連接的執行個體成功卸載區域開機磁碟，請在要求主體中加入 "forceAttach": true。