Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

將 Hyperdisk 集區中的磁碟新增至 VM

本文說明如何在集區中建立磁碟。

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

您無法將現有磁碟移入或移出集區。您必須從現有磁碟建立新磁碟。如要變更，請參閱「變更磁碟的類型、位置或位置」。

事前準備

如果尚未設定驗證，請先完成設定。驗證程序會確認您的身分，以便授予 Google Cloud 服務和 API 的存取權。如要從本機開發環境執行程式碼或範例，您可以選取下列其中一個選項，向 Compute Engine 進行驗證：
請根據您打算如何使用本頁範例，選取對應的分頁標籤：
控制台

使用 Google Cloud 控制台存取 Google Cloud 服務和 API 時，不需要設定驗證。
gcloud
1. 安裝 Google Cloud CLI。完成後，執行下列指令來初始化 Google Cloud CLI：
  gcloud init
  如果您使用外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。
  
  注意：如果您已經安裝 gcloud CLI，請務必執行 gcloud components update，確認您安裝的是最新版本。
設定預設區域和可用區。

Go

如要在本機開發環境中使用本頁面的 Go 範例，請安裝並初始化 gcloud CLI，然後使用使用者憑證設定應用程式預設憑證。

安裝 Google Cloud CLI。
如果您使用外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。
如果您使用的是本機殼層，請為使用者帳戶建立本機驗證憑證：
```
gcloud auth application-default login
```
如果您使用 Cloud Shell，則不需要執行這項操作。

如果系統傳回驗證錯誤，且您使用外部識別資訊提供者 (IdP)，請確認您已使用聯合身分登入 gcloud CLI。

詳情請參閱「設定本機開發環境的驗證機制」。

Java

如要在本機開發環境中使用本頁的 Java 範例，請安裝並初始化 gcloud CLI，然後使用使用者憑證設定應用程式預設憑證。

安裝 Google Cloud CLI。
如果您使用外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。
如果您使用本機殼層，請為使用者帳戶建立本機驗證憑證：
```
gcloud auth application-default login
```
如果您使用的是 Cloud Shell，則不必執行這項操作。

如果系統傳回驗證錯誤，且您使用的是外部識別資訊提供者 (IdP)，請確認您已使用聯合身分登入 gcloud CLI。

詳情請參閱「設定本機開發環境的驗證機制」。

Node.js

如要在本機開發環境中使用本頁的 Node.js 範例，請安裝並初始化 gcloud CLI，然後使用使用者憑證設定應用程式預設憑證。

安裝 Google Cloud CLI。
若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。
如果您使用的是本機殼層，請為使用者帳戶建立本機驗證憑證：
```
gcloud auth application-default login
```
如果您使用 Cloud Shell，則不需要執行這項操作。

如果系統傳回驗證錯誤，且您使用的是外部識別資訊提供者 (IdP)，請確認您已使用聯合身分登入 gcloud CLI。

詳情請參閱「設定本機開發環境的驗證機制」。

REST

如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

安裝 Google Cloud CLI。

如果您使用外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」一節。

必要角色和權限

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

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

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

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

所需權限

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

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

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

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

限制

將磁碟新增至集區的限制：

您只能在 Hyperdisk Balanced 集區中建立 Hyperdisk Balanced 磁碟，以及在 Hyperdisk Throughput 集區中建立 Hyperdisk Throughput 磁碟。
只能在集區中建立相同專案和可用區的新磁碟。
集區不支援區域性磁碟。
您無法將磁碟移入或移出集區，必須從標準快照重新建立磁碟。詳情請參閱「變更磁碟類型」。
如要在集區中建立開機磁碟，必須使用 Hyperdisk Balanced 儲存空間集區或 Hyperdisk Balanced Exapool。

儲存空間集區的特定限制：

一個儲存空間集區最多可建立 10,000 個磁碟。

Exapools 的專屬限制：

一個 Exapool 最多可建立 500,000 個磁碟。

佈建選項

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

佈建磁碟容量

如果您使用 Exapool 或進階容量儲存空間集區，可以在集區中建立磁碟，累計大小超過集區的佈建容量。集區的已用容量取決於使用中的資料總量，而非佈建的磁碟空間量。您可以佈建磁碟，總容量最多分別為進階容量集區或 Hyperdisk Exapool 佈建容量的五倍或 50 倍。

如果您要在標準容量集區中建立磁碟，請在集區中建立磁碟，直到集區中所有磁碟的總大小達到集區的佈建容量為止。容量為 Standard 的集區磁碟與非集區磁碟的運作方式類似，建立磁碟時會耗用容量。

佈建效能

如果您使用 Exapool 或進階容量儲存空間集區，可以在集區中建立磁碟，其累計 IOPS 和輸送量會超過集區的佈建效能。集區的效能用量取決於磁碟使用的總效能，而非佈建給各磁碟的效能。

對於儲存空間集區，您可以佈建磁碟，其總效能最高可達進階效能集區佈建效能的 500%。
對於 Exapool，您佈建的磁碟總效能最多可達集區佈建寫入效能的 50 倍。

如果您要在 Standard 效能集區中建立磁碟，為磁碟佈建的 IOPS 或處理量必須小於 Hyperdisk 儲存空間集區中的可用 IOPS 或處理量。可用 IOPS 或處理量是指集區的佈建量，扣除集區中所有磁碟的用量。

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

範例

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

使用標準效能佈建時：

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

使用進階效能佈建：

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

在集區中建立磁碟

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

控制台

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

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

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

前往「儲存集區」頁面
選取「Exapools」或「Storage Pools」分頁標籤。
按一下要建立磁碟的集區名稱。
在「Manage storage pool」(管理儲存空間集區) 頁面，點選「+Create New Disk」(+ 建立新磁碟)。
在「Add new disk」(新增磁碟) 面板中，輸入磁碟的名稱。
指定或變更您不想使用預設值的任何值。
指定完磁碟屬性後，按一下「Save」(儲存)。
在「管理儲存空間集區」頁面中，您應該會在「儲存空間集區磁碟」部分看到新磁碟。

在「建立磁碟」頁面中：

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

前往「建立磁碟」頁面
輸入磁碟的「Name」(名稱)。
選取要建立磁碟的集區所在的可用區。
在「Disk type」(磁碟類型) 部分，選擇與集區相符的磁碟類型，也就是 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 代表 GiB，TB 代表 TiB。如未指定大小，系統會使用 100 GB 做為預設值。
DISK_TYPE：要建立的磁碟類型。這必須與 Hyperdisk 儲存空間集區的類型相符，也就是 hyperdisk-balanced 或 hyperdisk-throughput。
PROVISIONED_IOPS：選用：要為磁碟佈建的 IOPS。這個旗標只能與 Hyperdisk Balanced 磁碟搭配使用。
PROVISIONED_THROUGHPUT：選用：為磁碟佈建的 MiB/s 處理量。

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：選用：要為磁碟佈建的處理量 (MiB/秒)。

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 Exapool。接著，您可以使用支援 Hyperdisk Balanced 磁碟的機型建立執行個體。您選擇的可用區必須提供機型、磁碟類型和集區。

控制台

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

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

控制台會在指定可用區建立 VM，並在所選集區建立開機磁碟。

gcloud

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

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：VM 的機型，例如 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

您可以為集區中的新 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": [
      {
         "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：VM 的機型，例如 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」(新增磁碟) 面板中，輸入磁碟資訊。將「Disk type」(磁碟類型) 設為與集區類型相符。
在「儲存空間集區」部分，選取「啟用儲存空間集區」。
在「Select a storage pool」(選取儲存空間集區) 欄位中，選取要在其中建立磁碟的集區。
完成磁碟設定後，請按一下「儲存」。
完成 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：VM 的機型，例如 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」(執行個體範本) 頁面
按一下「建立執行個體範本」。
輸入執行個體範本名稱。
在位置部分選擇「Regional」(區域)，然後在「Region」(區域) 欄位中，選擇集區所在的區域。
選擇支援 Hyperdisk Balanced 的機型，例如 C3。
在「Boot disk」(開機磁碟) 區段，按一下 [Change] (變更)。
在「開機磁碟」面板中，將「開機磁碟類型」設為 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

如要為集區中的新 VM 建立開機磁碟，請為 instances.insert 方法建構 POST 要求，並加入開機磁碟的 storagePool 屬性。

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：VM 的機型，例如 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

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

事前準備

控制台

gcloud

Go

Java

Node.js

REST

必要角色和權限

所需權限

限制

佈建選項

佈建磁碟容量

佈建效能

在集區中建立磁碟

控制台

gcloud

REST

Go

Java

Node.js

建立 VM 並使用集區中的磁碟

在集區中建立 VM 的開機磁碟

控制台

gcloud

REST

在建立 VM 時，於集區中建立額外磁碟

控制台

gcloud

REST

在執行個體範本中使用集區

控制台

gcloud

REST

將 Hyperdisk 集區中的磁碟新增至 VM