本頁面由 Cloud Translation API 翻譯而成。

將儲存體資源池中的磁碟新增至 VM

您可以在 Hyperdisk 儲存空間集區中建立磁碟，然後將磁碟連接至虛擬機器 (VM) 執行個體，也可以在建立 VM 時，於儲存空間集區中建立磁碟。

事前準備

如果尚未設定驗證，請先完成設定。「驗證」是指驗證身分的程序，確認您有權存取 Google Cloud 服務和 API。如要從本機開發環境執行程式碼或範例，請選取下列其中一個選項，向 Compute Engine 進行驗證：

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

必要角色和權限

如要取得在儲存集區中建立 Hyperdisk Balanced 或 Hyperdisk Throughput 磁碟所需的權限，請要求管理員授予您專案的下列 IAM 角色：

Compute 執行個體管理員 (v1) (roles/compute.instanceAdmin.v1)
如要連線至可當做服務帳戶執行的 VM 執行個體：服務帳戶使用者 (v1) (roles/iam.serviceAccountUser 角色)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這些預先定義的角色具備在儲存空間集區中建立 Hyperdisk Balanced 或 Hyperdisk Throughput 磁碟所需的權限。如要查看確切的必要權限，請展開「必要權限」部分：

所需權限

如要在儲存空間集區中建立 Hyperdisk Balanced 或 Hyperdisk Throughput 磁碟，必須具備下列權限：

如要在儲存集區中建立磁碟，並將磁碟連接至 VM 執行個體，請按照下列步驟操作：
- 專案的 compute.disks.create
- compute.instances.attachDisk 在 VM 上
- compute.disks.use 要附加至 VM 的磁碟區
- compute.storagePools.use 您要在其中建立磁碟的儲存空間集區
如要格式化及掛接連結的磁碟區，請在 VM 上執行下列操作： compute.instances.setMetadata

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

如要瞭解建立執行個體所需的權限，請參閱必要權限。

限制

在 Hyperdisk 儲存空間集區中建立磁碟時，請注意下列限制：

您只能在 Hyperdisk Balanced 儲存空間集區中建立 Hyperdisk Balanced 磁碟，也只能在 Hyperdisk Throughput 儲存空間集區中建立 Hyperdisk Throughput 磁碟。
只有位於相同專案和可用區的新磁碟，才能在儲存空間集區中建立。
如要在儲存空間集區中建立開機磁碟，必須使用 Hyperdisk Balanced 儲存空間集區。
不允許在儲存空間集區中移動磁碟。如要將磁碟移入或移出儲存集區，必須從快照重新建立磁碟。詳情請參閱「變更磁碟類型」。
一個儲存集區最多可建立 1,000 個磁碟。
儲存空間集區不支援區域磁碟。

佈建選項

視 Hyperdisk 儲存空間集區的佈建類型而定，您可以選擇如何佈建在儲存空間集區中建立的每個磁碟的容量和效能。

佈建磁碟容量

如果建立進階容量儲存空間集區，可以使用精簡佈建。您可以在儲存空間集區中建立磁碟，累計大小可超過集區的佈建容量。儲存空間集區的使用容量是由使用的資料總量決定，而非您佈建的磁碟空間量。您可以佈建磁碟，總容量最高可達進階容量儲存空間集區佈建容量的 500%。

如果您要在標準容量儲存空間集區中建立磁碟，請在儲存空間集區中建立磁碟，直到儲存空間集區中所有磁碟的總大小達到儲存空間集區的佈建容量為止。儲存空間集區中的磁碟容量為標準容量，行為與非集區磁碟類似，建立磁碟時會耗用容量。

佈建效能

如果您建立進階效能儲存集區，可以使用精簡佈建。您可以在儲存空間集區中建立磁碟，其累計 IOPS 和總處理量會超過集區的佈建效能。儲存空間集區的已用效能是由磁碟使用的總效能決定，而非佈建給每個磁碟的效能。您可以佈建磁碟，其匯總效能最高可達進階效能儲存空間集區佈建效能的 500%。

如果您要在「標準」效能儲存空間集區中建立磁碟，為磁碟佈建的 IOPS 或總處理量必須低於 Hyperdisk 儲存空間集區中的可用 IOPS 或總處理量。可用 IOPS 或輸送量是指儲存空間集區的佈建量，扣除儲存空間集區中所有磁碟的使用量。

如果上一段中的任何條件不成立，在儲存集區中建立磁碟的要求就會失敗，且不會建立磁碟。

範例

假設您有一個 Hyperdisk Balanced 儲存空間集區，佈建的 IOPS 為 100,000。

使用標準效能佈建時：

在儲存空間集區中建立 Hyperdisk Balanced 磁碟時，最多可佈建 100,000 個匯總 IOPS。
系統會針對 Hyperdisk 已平衡儲存空間集區佈建的 100,000 IOPS 效能計費。
與在儲存空間集區外建立的磁碟一樣，標準效能儲存空間集區中的 Hyperdisk Balanced 磁碟，會自動佈建最多 3,000 個基準 IOPS 和 140 MiB/秒的基準輸送量。這項基準效能不會計入儲存空間集區的佈建效能。只有在您將磁碟新增至儲存空間集區時，佈建的效能高於基準效能，才會計入儲存空間集區的佈建效能，例如：
- 佈建 3,000 IOPS 的磁碟會使用 0 個集區 IOPS，集區仍有 100,000 個佈建的 IOPS 可供其他磁碟使用。
- 如果磁碟佈建了 13,000 IOPS，就會使用 10,000 個集區 IOPS，而集區還剩下 90,000 個佈建 IOPS，可分配給儲存空間集區中的其他磁碟。

進階效能佈建：

在儲存空間集區中建立磁碟時，最多可佈建 500,000 IOPS 的 Hyperdisk 總效能。
您需要為儲存空間集區佈建的 100,000 IOPS 付費。
如果您在儲存空間集區中建立一個 IOPS 為 5,000 的磁碟 (Disk1)，就不會耗用儲存空間集區佈建的 IOPS。不過，您現在可以為儲存空間集區中建立的新磁碟佈建 495,000 個 IOPS。
如果 Disk1 開始讀取及寫入資料，且在一分鐘內使用 5,000 IOPS 的上限，則儲存空間集區佈建的 IOPS 會消耗 5,000 IOPS。在同一個儲存空間集區中建立的任何其他磁碟，在同一分鐘內最多可使用 95,000 個 IOPS，不會發生爭用。

在儲存空間集區中建立磁碟

您可以使用 Google Cloud 控制台、Google Cloud CLI 或 REST，在儲存集區中建立磁碟。

主控台

您可以使用 Google Cloud 控制台，透過「儲存集區」頁面或「磁碟」頁面，在儲存集區中建立新磁碟。

在「儲存空間集區」頁面中：

在 Google Cloud 控制台，前往「儲存集區」頁面。

前往「儲存集區」頁面
按一下要建立磁碟的儲存空間集區名稱。
在「管理儲存空間集區」頁面中，按一下「+ 建立新磁碟」。
在「Add new disk」(新增磁碟) 面板中，輸入磁碟的「Name」(名稱)。
指定或變更不想使用預設值的任何值。
指定磁碟屬性完成後，請按一下「儲存」。
在「管理儲存空間集區」頁面，您應該會在「儲存空間集區磁碟」區段中看到新磁碟。

在「Create Disk」(建立磁碟) 頁面中：

在 Google Cloud 控制台中，依序前往「Disks」(磁碟) >「Create a disk」(建立磁碟) 頁面。

前往「建立磁碟」頁面
輸入磁碟的「Name」(名稱)。
選取要建立磁碟的儲存空間集區所在的區域。
在「磁碟類型」中，選擇與 Hyperdisk 儲存空間集區相符的磁碟類型，即 Hyperdisk Throughput 或 Hyperdisk Balanced。
視需要修改「大小」、「佈建的 IOPS」和「佈建的總處理量」欄位值。
在「儲存空間集區」部分，選取「啟用儲存空間集區」，然後選擇要在哪個儲存空間集區中建立磁碟。清單中只會顯示所選區域中的儲存空間集區。
指定磁碟資訊後，按一下「建立」。

gcloud

如要在儲存集區中建立一或多個磁碟，請使用 gcloud compute disks create 指令。

gcloud compute disks create DISK_NAME \
    --zone=ZONE \
    --storage-pool=STORAGE_POOL_NAME \
    --size=SIZE \
    --type=DISK_TYPE \
    --provisioned-iops=PROVISIONED_IOPS \
    --provisioned-throughput=PROVISIONED_THROUGHPUT

更改下列內容：

DISK_NAME：磁碟的專屬名稱。您可以提供以空格分隔的磁碟名稱清單，建立多個具有相同屬性的磁碟。
ZONE：建立儲存集區的可用區。以「地區-區域」格式指定這個值，例如 us-central1-a。
STORAGE_POOL_NAME：要在其中建立磁碟的儲存空間集區名稱
SIZE：(選填) 新磁碟的佈建容量。值必須是整數，後接大小單位，例如 GB 代表 gibibyte，TB 代表 tebibyte。如未指定大小，系統會使用 100 GB 做為預設值。
DISK_TYPE：要建立的磁碟類型。這必須與 Hyperdisk 儲存空間集區的類型相符，也就是 hyperdisk-balanced 或 hyperdisk-throughput。
PROVISIONED_IOPS：(選填) 要為磁碟佈建的 IOPS。這個標記只能與 Hyperdisk Balanced 磁碟搭配使用。
PROVISIONED_THROUGHPUT：(選填) 要為磁碟佈建的每秒百萬位元組 (MB) 輸送量。

REST

如要在儲存集區中建立一或多個磁碟，請使用 disks.insert 方法建構 POST。請包含 name、sizeGb、type、storagePool、provisionedIops 和 provisionedThroughput 屬性。如要將這個磁碟建立為空白且未格式化的非開機磁碟，請勿指定來源映像檔或來源快照。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks

{
    "name": "DISK_NAME",
    "description": "DESCRIPTION",
    "type": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE",
    "sizeGb": "DISK_SIZE",
    "storagePool": "STORAGE_POOL_NAME",
    "provisionedIops": "IOPS_LIMIT",
    "provisionedThroughput": "THROUGHPUT_LIMIT",
}

更改下列內容：

PROJECT_ID：專案 ID
ZONE：儲存集區所在的可用區，例如 us-central1-a。這是要建立磁碟的區域。
DISK_NAME：磁碟的專屬名稱。
DESCRIPTION：(選用) 描述磁碟的文字字串。
DISK_TYPE：磁碟類型，必須與儲存集區類型相符。使用 hyperdisk-throughput 或 hyperdisk-balanced。
DISK_SIZE：(選填) 新磁碟的大小。這個值必須是整數，後接 GB (吉位元組) 或 TB (特位元組) 的大小單位。如未指定大小，系統會使用 100 GB 做為預設值。
STORAGE_POOL_NAME：要在其中建立磁碟的儲存集區名稱。
IOPS_LIMIT：(選填) 要為磁碟佈建的 IOPS。這個標記只能與 Hyperdisk Balanced 磁碟搭配使用。
THROUGHPUT_LIMIT：(選填) 為磁碟佈建的每秒處理量 (MB)。

Go


// createDiskInStoragePool creates a new Hyperdisk in the specified storage pool.
func createDiskInStoragePool(w io.Writer, projectId, zone, diskName, storagePoolName, diskType string) error {
	// Example usage:
	//   projectID := "your_project_id"
	//   zone := "europe-central2-b"
	//   diskName := "your_disk_name"
	//   storagePoolName := "https://www.googleapis.com/compute/v1/projects/your_project_id/zones/europe-central2-b/storagePools/your_storage_pool"
	//   diskType := "zones/europe-central2-b/diskTypes/hyperdisk-balanced"

	ctx := context.Background()
	client, err := compute.NewDisksRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewDisksRESTClient: %v", err)
	}
	defer client.Close()

	// Create the disk resource
	disk := &computepb.Disk{
		Name:                  proto.String(diskName),
		Type:                  proto.String(diskType),
		SizeGb:                proto.Int64(50),
		Zone:                  proto.String(zone),
		StoragePool:           proto.String(storagePoolName),
		ProvisionedIops:       proto.Int64(10000),
		ProvisionedThroughput: proto.Int64(1024),
	}

	// Create the insert disk request
	req := &computepb.InsertDiskRequest{
		Project:      projectId,
		Zone:         zone,
		DiskResource: disk,
	}

	// Send the insert disk request
	op, err := client.Insert(ctx, req)
	if err != nil {
		return fmt.Errorf("Insert disk request failed: %v", err)
	}

	// Wait for the insert disk operation to complete
	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}

	fmt.Fprintf(w, "Disk created in storage pool: %v\n", disk.Name)
	return nil
}

Java


import com.google.cloud.compute.v1.Disk;
import com.google.cloud.compute.v1.DisksClient;
import com.google.cloud.compute.v1.InsertDiskRequest;
import com.google.cloud.compute.v1.Operation;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class CreateDiskInStoragePool {
  public static void main(String[] args)
          throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Google Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";
    // Name of the zone in which you want to create the disk.
    String zone = "europe-central2-b";
    // Name of the disk you want to create.
    String diskName = "YOUR_DISK_NAME";
    // Link to the storagePool you want to use. Use format :
    // https://www.googleapis.com/compute/v1/projects/%s/zones/%s/storagePools/%s"
    String storagePoolName = "YOUR_STORAGE_POOL_LINK";
    // The type of disk you want to create. This value uses the following format:
    // "zones/{zone}/diskTypes/(hyperdisk-balanced|hyperdisk-throughput)".
    // For example: "zones/us-west3-b/diskTypes/hyperdisk-balanced"
    String diskType = String.format("zones/%s/diskTypes/hyperdisk-balanced", zone);
    // Size of the new disk in gigabytes.
    long diskSizeGb = 10;
    // Optional: the IOPS to provision for the disk.
    // You can use this flag only with Hyperdisk Balanced disks.
    long provisionedIops = 3000;
    // Optional: the throughput in mebibyte (MB) per second to provision for the disk.
    long provisionedThroughput = 140;

    createDiskInStoragePool(projectId, zone, diskName, storagePoolName, diskType,
            diskSizeGb, provisionedIops, provisionedThroughput);
  }

  // Creates a hyperdisk in the storage pool
  public static Disk createDiskInStoragePool(String projectId, String zone, String diskName,
                                             String storagePoolName, String diskType,
                                             long diskSizeGb, long iops, long throughput)
          throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (DisksClient client = DisksClient.create()) {
      // Create a disk.
      Disk disk = Disk.newBuilder()
              .setZone(zone)
              .setName(diskName)
              .setType(diskType)
              .setSizeGb(diskSizeGb)
              .setStoragePool(storagePoolName)
              .setProvisionedIops(iops)
              .setProvisionedThroughput(throughput)
              .build();

      InsertDiskRequest request = InsertDiskRequest.newBuilder()
              .setProject(projectId)
              .setZone(zone)
              .setDiskResource(disk)
              .build();

      // Wait for the insert disk operation to complete.
      Operation operation = client.insertAsync(request).get(1, TimeUnit.MINUTES);

      if (operation.hasError()) {
        System.out.println("Disk creation failed!");
        throw new Error(operation.getError().toString());
      }

      // Wait for server update
      TimeUnit.SECONDS.sleep(10);

      Disk hyperdisk = client.get(projectId, zone, diskName);

      System.out.printf("Hyperdisk '%s' has been created successfully", hyperdisk.getName());

      return hyperdisk;
    }
  }
}

Node.js

// Import the Compute library
const computeLib = require('@google-cloud/compute');
const compute = computeLib.protos.google.cloud.compute.v1;

// Instantiate a diskClient
const disksClient = new computeLib.DisksClient();
// Instantiate a zoneOperationsClient
const zoneOperationsClient = new computeLib.ZoneOperationsClient();

/**
 * TODO(developer): Update/uncomment these variables before running the sample.
 */
// Project ID or project number of the Google Cloud project you want to use.
const projectId = await disksClient.getProjectId();

// The zone where your VM and new disk are located.
// zone = 'us-central1-a';

// The name of the new disk
// diskName = 'disk-from-pool-name';

// The name of the storage pool
// storagePoolName = 'storage-pool-name';

// Link to the storagePool you want to use. Use format:
// https://www.googleapis.com/compute/v1/projects/{projectId}/zones/{zone}/storagePools/{storagePoolName}
const storagePool = `https://www.googleapis.com/compute/v1/projects/${projectId}/zones/${zone}/storagePools/${storagePoolName}`;
// The type of disk. This value uses the following format:
// "zones/{zone}/diskTypes/(hyperdisk-balanced|hyperdisk-extreme|hyperdisk-ml|hyperdisk-throughput)".
// For example: "zones/us-west3-b/diskTypes/hyperdisk-balanced"
const diskType = `zones/${zone}/diskTypes/hyperdisk-balanced`;
// Size of the new disk in gigabytes.
const diskSizeGb = 10;
// Optional: For Hyperdisk Balanced or Hyperdisk Extreme disks,
// this is the number of I/O operations per second (IOPS) that the disk can handle.
const provisionedIops = 3000;
// Optional: For Hyperdisk Balanced or Hyperdisk Throughput volumes,
// this is an integer that represents the throughput,
// measured in MiB per second, that the disk can handle.
const provisionedThroughput = 140;

async function callCreateComputeHyperdiskFromPool() {
  // Create a disk
  const disk = new compute.Disk({
    sizeGb: diskSizeGb,
    name: diskName,
    type: diskType,
    zone,
    storagePool,
    provisionedIops,
    provisionedThroughput,
  });

  const [response] = await disksClient.insert({
    project: projectId,
    zone,
    diskResource: disk,
  });

  let operation = response.latestResponse;

  // Wait for the create disk operation to complete.
  while (operation.status !== 'DONE') {
    [operation] = await zoneOperationsClient.wait({
      operation: operation.name,
      project: projectId,
      zone: operation.zone.split('/').pop(),
    });
  }

  console.log(`Disk: ${diskName} created.`);
}

await callCreateComputeHyperdiskFromPool();

建立磁碟後，您可以將磁碟連接至 VM。

建立使用儲存集區中磁碟的 VM

建立 VM 時，您可以設定開機磁碟，並視需要建立其他資料 (非開機) 磁碟，這些磁碟會自動附加至 VM。下列各節說明如何在建立 VM 時，於儲存集區中建立各類磁碟。

在儲存空間集區中建立 VM 的開機磁碟

如要建立使用儲存空間集區中開機磁碟的 VM，您必須先建立 Hyperdisk Balanced 儲存空間集區。接著，您可以使用支援 Hyperdisk Balanced 磁碟的機器類型建立 VM。所選可用區必須提供機器類型、磁碟類型和儲存空間集區。

主控台

前往 Google Cloud 控制台的「VM Instances」(VM 執行個體) 頁面。

前往 VM 執行個體
點選「建立執行個體」。
輸入執行個體的名稱。
將區域設為儲存集區所在的區域。
選擇支援 Hyperdisk Balanced 的機器類型，例如 H3。
在「Boot disk」(開機磁碟) 區段，按一下 [Change] (變更)。
在「Boot disk」(開機磁碟) 面板中，將「Boot disk type」(開機磁碟類型) 設為「Hyperdisk Balanced」(平衡超磁碟)。
設定磁碟的屬性。
展開「顯示進階設定」。
在「儲存空間集區」標題下方，選取「啟用儲存空間集區」。
從清單中選擇要在哪個儲存空間集區中建立磁碟。
完成磁碟設定後，按一下「選取」。
完成 VM 屬性設定。
點選「建立」。

主控台會在指定可用區中建立 VM，並在所選儲存空間集區中建立開機磁碟。

gcloud

您可以使用 gcloud compute instances create 指令，並加入開機磁碟的 storage-pool 屬性，在儲存集區中為新 VM 建立開機磁碟。

gcloud compute instances create VM_NAME \
    --zone=ZONE \
    --machine-type=MACHINE_TYPE \
    --create-disk=boot=yes,type=hyperdisk-balanced,size=DISK_SIZE,provisioned-throughput=THROUGHPUT, \
    provisioned-iops=IOPS,image=projects/IMAGE_PROJECT/global/images/IMAGE, \
    storage-pool=STORAGE_POOL_NAME

更改下列內容：

VM_NAME：VM 名稱。
ZONE：建立 VM 的區域和可用區，格式為 us-central1-a。
MACHINE_TYPE：虛擬機的機器類型，例如 m3-ultramem-32。
DISK_SIZE：開機磁碟的大小 (以 GiB 為單位)
THROUGHPUT：要為磁碟佈建的處理量
IOPS：要為磁碟佈建的 IOPS
IMAGE_PROJECT：包含圖片的專案
IMAGE：指定下列其中一項：
- 特定版本的 OS 映像檔，例如 debian-12-bookworm-v20240213。
- 映像檔系列，格式必須為 family/IMAGE_FAMILY。這樣一來，系統會使用未淘汰的最新 OS 映像檔建立執行個體。舉例來說，如果您指定 family/debian-12，Compute Engine 會使用 debian-12 映像檔系列中的最新 OS 映像檔版本建立 VM。如要進一步瞭解如何使用映像檔系列，請參閱「映像檔系列最佳做法」。
STORAGE_POOL_NAME：要在其中建立新磁碟的儲存空間集區名稱。

REST

您可以對 instances.insert 方法建構 POST 要求，並納入開機磁碟的 storagePool 屬性，在儲存集區中為新 VM 建立開機磁碟。

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

{
   "name": "VM_NAME",
   "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
   "disks": [
      {
         "deviceName": "BOOT_DISK_DEVICE_NAME",
         "initializeParams": {
            "diskSizeGb": "DISK_SIZE",
            "diskType": "DISK_TYPE",
            "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
            "boot": true,
            "provisionedIops": "IOPS_LIMIT",
            "provisionedThroughput": "THROUGHPUT_LIMIT",
            "storagePool": "POOL_URL"
         }
      }
   ]
}

更改下列內容：

PROJECT_ID：專案 ID
ZONE：儲存集區所在的可用區，例如 us-central1-a。這是建立 VM 和開機磁碟的區域。
VM_NAME：VM 名稱。
MACHINE_TYPE：虛擬機的機器類型，例如 m3-ultramem-32。
BOOT_DISK_DEVICE_NAME：開機磁碟的裝置名稱
DISK_SIZE：開機磁碟的大小 (以 GiB 為單位)
DISK_TYPE：磁碟類型，以 URI 形式指定
IMAGE_PROJECT：包含圖片的專案
IMAGE：指定下列其中一項：
- 特定版本的 OS 映像檔，例如 debian-12-bookworm-v20240213。
- 映像檔系列，格式必須為 family/IMAGE_FAMILY。這樣一來，系統會使用未淘汰的最新 OS 映像檔建立執行個體。舉例來說，如果您指定 family/debian-12，Compute Engine 會使用 debian-12 映像檔系列中的最新 OS 映像檔版本建立 VM。如要進一步瞭解如何使用映像檔系列，請參閱「映像檔系列最佳做法」。
IOPS_LIMIT：要為磁碟佈建的 IOPS
THROUGHPUT_LIMIT：要為磁碟佈建的處理量
POOL_URL：新磁碟建立所在的儲存集區。你可以提供資源的部分或完整網址。舉例來說，以下是有效值：
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
- projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
- zones/ZONE/storagePools/STORAGE_POOL_NAME

在建立 VM 時，於儲存集區中建立其他磁碟

在建立 VM 時，如果要在儲存集區中建立磁碟，所選可用區必須提供機器類型、磁碟類型和儲存集區。

主控台

如要使用控制台建立含有額外非開機磁碟的新 VM，請按照下列步驟操作：

前往 Google Cloud 控制台的「VM Instances」(VM 執行個體) 頁面。

前往 VM 執行個體
點選「建立執行個體」。
輸入 VM 的名稱。
將區域設為儲存集區所在的區域。
選擇支援儲存集區所用磁碟類型的機器類型。
展開「Advanced options」(進階選項) 區段。
展開「磁碟」。
按一下「新增磁碟」。
在「Add new disk」(新增磁碟) 面板中，輸入磁碟的資訊。將「磁碟類型」設為與儲存空間集區類型相符。
在「儲存空間集區」部分，選取「啟用儲存空間集區」。
在「選取儲存空間集區」欄位中，選取要建立磁碟的儲存空間集區。
完成磁碟設定後，按一下「儲存」。
完成 VM 屬性設定。
點選「建立」。

主控台會在指定區域中建立 VM，並在所選儲存空間集區中建立非開機磁碟。

gcloud

您可以在建立 VM 時，使用 gcloud compute instances create 指令在儲存集區中建立新磁碟，並加入磁碟的 storage-pool 屬性。

gcloud compute instances create VM_NAME \
    --zone=ZONE \
    --machine-type=MACHINE_TYPE \
    --create-disk=auto-delete=yes,boot=yes,device-name=BOOT_DISK_DEVICE_NAME,image=IMAGE_NAME, \
    size=BOOT_DISK_SIZE,type=BOOT_DISK_TYPE
    --create-disk=auto-delete=yes,boot=no,device-name=DATA_DISK_DEVICE_NAME,size=DATA_DISK_SIZE, \
    type=DATA_DISK_TYPE,provisioned-iops=IOPS,provisioned-throughput=THROUGHPUT, \
    storage_pool=STORAGE_POOL_NAME

更改下列內容：

VM_NAME：VM 名稱。
ZONE：建立 VM 的區域和可用區，格式為 us-central1-a
MACHINE_TYPE：VM 的機器類型
BOOT_DISK_DEVICE_NAME：開機磁碟的裝置名稱
IMAGE_NAME：要安裝在開機磁碟上的作業系統映像檔名稱，例如 debian-12-bookworm-v20240213
BOOT_DISK_SIZE：開機磁碟的大小 (以 GiB 為單位)
BOOT_DISK_TYPE：磁碟類型
DATA_DISK_DEVICE_NAME：資料磁碟的磁碟裝置名稱
DATA_DISK_SIZE：資料磁碟大小 (以 GiB 為單位)
DATA_DISK_TYPE：資料磁碟類型，可以是 hyperdisk-balanced 或 hyperdisk-throughput
IOPS：要為磁碟佈建的 IOPS
THROUGHPUT：要為磁碟佈建的處理量
STORAGE_POOL_NAME：要建立磁碟的儲存集區專屬名稱。

REST

您可以在建立 VM 時，對 instances.insert 方法建構 POST 要求，並納入額外磁碟的 storagePool 屬性，在儲存集區中建立新磁碟。

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

{
   "name": "VM_NAME",
   "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
   "disks": [
      {
        "initializeParams":{
            "sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE"
        },
        "boot":true
      },
      {
        "deviceName": "DEVICE_NAME",
        "boot":false,
        "initializeParams": {
           "diskSizeGb": "DISK_SIZE",
           "diskType": "DISK_TYPE",
           "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
           "provisionedIops": "IOPS_LIMIT",
           "provisionedThroughput": "THROUGHPUT_LIMIT",
           "storagePool": "POOL_URL"
        }
      }
   ]
}

更改下列內容：

PROJECT_ID：專案 ID
ZONE：儲存集區所在的可用區，例如 us-central1-a。這是建立 VM 和開機磁碟的區域。
VM_NAME：VM 名稱。
MACHINE_TYPE：虛擬機的機器類型，例如 m3-ultramem-32。
IMAGE_PROJECT：包含圖片的專案
IMAGE：指定下列其中一項：
- 特定版本的 OS 映像檔，例如 debian-12-bookworm-v20240213。
- 映像檔系列，格式必須為 family/IMAGE_FAMILY。這樣一來，系統會使用未淘汰的最新 OS 映像檔建立執行個體。舉例來說，如果您指定 family/debian-12，Compute Engine 會使用 debian-12 映像檔系列中的最新 OS 映像檔版本建立 VM。如要進一步瞭解如何使用映像檔系列，請參閱「映像檔系列最佳做法」。
DEVICE_NAME：資料磁碟的裝置名稱
DISK_SIZE：資料磁碟的大小 (以 GiB 為單位)
DISK_TYPE：磁碟類型，以 URI 形式指定
IOPS_LIMIT：要為磁碟佈建的 IOPS
THROUGHPUT_LIMIT：要為磁碟佈建的處理量
POOL_URL：新磁碟建立所在的儲存集區。你可以提供資源的部分或完整網址。舉例來說，以下是有效值：
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
- projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
- zones/ZONE/storagePools/STORAGE_POOL_NAME

在執行個體範本中使用儲存空間集區

用於建立代管執行個體群組 (MIG) 的執行個體範本可以包含儲存集區資訊。使用執行個體範本建立的磁碟會放置在指定的儲存空間集區中。

主控台

前往 Google Cloud 控制台的「Instance Templates」(執行個體範本) 頁面。

前往「Instance templates」(執行個體範本) 頁面
按一下「建立執行個體範本」。
輸入執行個體範本的名稱。
選擇「區域」做為位置，然後在「區域」欄位中，選擇儲存空間集區所在的區域。
選擇支援 Hyperdisk Balanced 的機器類型，例如 C3。
在「Boot disk」(開機磁碟) 區段，按一下 [Change] (變更)。
在「Boot disk」(開機磁碟) 面板中，將「Boot disk type」(開機磁碟類型) 設為「Hyperdisk Balanced」(平衡超磁碟)。
設定磁碟的屬性。
展開「顯示進階設定」。
在「儲存空間集區」標題下方，選取「啟用儲存空間集區」。
從清單中選擇要在哪個儲存空間集區中建立磁碟。
完成磁碟設定後，按一下「選取」。
完成 VM 屬性設定。
點選「建立」。

範本會在指定可用區中建立 VM，並在所選儲存空間集區中建立開機磁碟。

gcloud

您可以在執行個體範本中指定使用 gcloud compute instance-templates create 指令，並加入開機磁碟的 storage-pool 屬性，在儲存集區中建立開機磁碟。

gcloud compute instance-templates create TEMPLATE_NAME \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE \
    --create-disk=boot=yes,type=hyperdisk-balanced,size=DISK_SIZE,provisioned-throughput=THROUGHPUT, \
    provisioned-iops=IOPS,image=projects/IMAGE_PROJECT/global/images/IMAGE, \
    storage-pool=STORAGE_POOL_NAME

更改下列內容：

TEMPLATE_NAME：執行個體範本的名稱。
REGION：要建立區域執行個體範本的區域。該區域必須包含儲存集區所在的可用區。
MACHINE_TYPE：建立 VM 時要使用的機器類型，例如 h3-standard-88。
DISK_SIZE：磁碟大小 (以 GiB 為單位)
THROUGHPUT：要為磁碟佈建的處理量
IOPS：要為磁碟佈建的 IOPS
IMAGE_PROJECT：包含映像檔的專案
IMAGE：指定下列其中一項：
- 特定版本的 OS 映像檔，例如 debian-12-bookworm-v20240213。
- 映像檔系列，格式必須為 family/IMAGE_FAMILY。這樣一來，系統會使用未淘汰的最新 OS 映像檔建立執行個體。舉例來說，如果您指定 family/debian-12，Compute Engine 會使用 debian-12 映像檔系列中的最新 OS 映像檔版本建立 VM。如要進一步瞭解如何使用映像檔系列，請參閱「映像檔系列最佳做法」。
STORAGE_POOL_NAME：要在其中建立新磁碟的儲存空間集區名稱。

REST

您可以對 instances.insert 方法建構 POST 要求，並納入開機磁碟的 storagePool 屬性，在儲存集區中為新 VM 建立開機磁碟。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates
{
   "name": "VM_NAME",
   "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
   "disks": [
      {
         "deviceName": "BOOT_DISK_DEVICE_NAME",
         "initializeParams": {
            "diskSizeGb": "DISK_SIZE",
            "diskType": "DISK_TYPE",
            "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
            "boot": true,
            "provisionedIops": "IOPS_LIMIT",
            "provisionedThroughput": "THROUGHPUT_LIMIT",
            "storagePool": "POOL_URL"
         }
      }
   ]
}

更改下列內容：

PROJECT_ID：專案 ID
VM_NAME：VM 名稱。
ZONE：儲存集區所在的可用區，例如 us-central1-a。這是建立 VM 和開機磁碟的區域。
MACHINE_TYPE：虛擬機的機器類型，例如 m3-ultramem-32。
BOOT_DISK_DEVICE_NAME：開機磁碟的裝置名稱
DISK_SIZE：開機磁碟的大小 (以 GiB 為單位)
DISK_TYPE：磁碟類型，以 URI 形式指定
IMAGE_PROJECT：包含映像檔的專案
IMAGE：指定下列其中一項：
- 特定版本的 OS 映像檔，例如 debian-12-bookworm-v20240213。
- 映像檔系列，格式必須為 family/IMAGE_FAMILY。這樣一來，系統會使用未淘汰的最新 OS 映像檔建立執行個體。舉例來說，如果您指定 family/debian-12，Compute Engine 會使用 debian-12 映像檔系列中的最新版 OS 映像檔建立執行個體。如要進一步瞭解如何使用映像檔系列，請參閱「映像檔系列最佳做法」。
IOPS_LIMIT：要為磁碟佈建的 IOPS
THROUGHPUT_LIMIT：要為磁碟佈建的處理量
POOL_URL：新磁碟建立所在的儲存集區。你可以提供資源的部分或完整網址。舉例來說，以下是有效值：
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
- projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME
- zones/ZONE/storagePools/STORAGE_POOL_NAME

將儲存體資源池中的磁碟新增至 VM 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

Console

gcloud

Go

Java

Node.js

REST

必要角色和權限

所需權限

限制

佈建選項

佈建磁碟容量

佈建效能

在儲存空間集區中建立磁碟

主控台

gcloud

REST

Go

Java

Node.js

建立使用儲存集區中磁碟的 VM

在儲存空間集區中建立 VM 的開機磁碟

主控台

gcloud

REST

在建立 VM 時，於儲存集區中建立其他磁碟

主控台

gcloud

REST

在執行個體範本中使用儲存空間集區

主控台

gcloud

REST

將儲存體資源池中的磁碟新增至 VM