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

建立新的 Hyperdisk 磁碟區

如要搭配 Compute Engine 執行個體使用 Hyperdisk Balanced、Hyperdisk Extreme 或 Hyperdisk Throughput 磁碟區，請完成下列工作：

建立空白、非開機的區域性 Hyperdisk 磁碟區，並在建立執行個體時或之後將其附加至執行個體。
格式化並掛接磁碟區，以便存取資料或檔案系統。

對於 Hyperdisk Balanced 磁碟區，您也可以建立開機磁碟和資料磁碟。

如要在執行個體中新增 Hyperdisk Balanced High Availability 磁碟，請按照下列程序操作：

如要將含有資料的現有磁碟新增至執行個體，請參閱「將非開機磁碟連接至 VM」。

如需 Hyperdisk 的一般資訊，請參閱「關於 Hyperdisk」。

事前準備

將 Hyperdisk 磁碟區新增至運算執行個體前，請先詳閱 Hyperdisk 限制。
如果尚未設定驗證，請先完成設定。驗證程序會確認您的身分，以便授予 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 磁碟區新增至執行個體所需的權限，請要求管理員在專案中授予您下列 IAM 角色：

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

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

這些預先定義的角色具備將 Hyperdisk 磁碟區新增至執行個體所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要將 Hyperdisk 磁碟區新增至執行個體，必須具備下列權限：

如要建立及連接 Hyperdisk 磁碟區，請按照下列步驟操作：
- 專案有 compute.disks.create
- compute.instances.attachDisk 執行個體
- compute.disks.use 在要附加至執行個體的磁碟區上
如要格式化及掛接附加的磁碟區，請在執行個體上執行以下操作： compute.instances.setMetadata

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

Hyperdisk 磁碟區支援的值

Hyperdisk 的大小限制和參照名稱

如要使用 Google Cloud CLI、REST 或 Compute Engine 適用的 Cloud 用戶端程式庫建立 Hyperdisk 磁碟區，您必須提供下表「參考名稱」欄中的值，指明要建立的 Hyperdisk 類型。

您為 Hyperdisk 磁碟區指定的大小，必須在下表列出的範圍內。

磁碟類型	參照名稱	大小下限	大小上限	預設大小
Hyperdisk Balanced	`hyperdisk-balanced`	4 GiB	64 TiB¹	100 GiB
Hyperdisk Balanced High Availability	`hyperdisk-balanced-high-availability`	4 GiB	64 TiB	100 GiB
Hyperdisk Extreme	`hyperdisk-extreme`	64 GiB	64 TiB	1 TiB
Hyperdisk Throughput	`hyperdisk-throughput`	2 TiB	32 TiB	2 TiB
Hyperdisk ML	`hyperdisk-ml`	4 GiB	64 TiB	100 GiB

¹ 預先發布版： C4 支援的最大磁碟大小為 128 TiB。如要存取這項功能，請聯絡 hyperdisk-questions@google.com。

不過，附加至執行個體的所有 Hyperdisk 磁碟區總大小，不得超過執行個體的 Hyperdisk 大小和附加限制。

效能限制

下表列出可為各 Hyperdisk 類型指定的效能限制。不過，您可以指定的 IOPS 和處理量等級也取決於磁碟區大小。如需各項限制的詳細摘要，請參閱 Hyperdisk Balanced、Hyperdisk Balanced High Availability、Hyperdisk Extreme、Hyperdisk ML 和 Hyperdisk Throughput 的「大小和效能限制」一節。

Hyperdisk 類型	IOPS 限制	處理量上限 (MiB/秒)
Hyperdisk Balanced	160,000	2,400
Hyperdisk Balanced High Availability	100,000	2,400
Hyperdisk Extreme	350,000	您無法為 Hyperdisk Extreme 磁碟區佈建處理量等級。每 1,000 IOPS 的輸送量為 250 MiB/秒，每個磁碟區的輸送量上限為 5,000 MiB/秒。
Hyperdisk ML	您無法佈建 IOPS 級別，但每 MiB/s 的佈建輸送量會隨附 16 個 IOPS，最多可達 33,554,432 個 IOPS。	2,097,152
Hyperdisk Throughput	您無法佈建 IOPS 層級，但每佈建 1 MiB/s 的佈建輸送量，就會有 4 個 IOPS，最多可達 9,600 個 IOPS。	2,400

在執行個體中新增 Hyperdisk 磁碟區

您可以使用本節列出的任一方法，建立及連接 Hyperdisk 磁碟區。

建立 Hyperdisk 磁碟區時，指定的大小、處理量和 IOPS 必須在支援的值範圍內。

建立 Hyperdisk Balanced 磁碟區時，您可以選擇以多重寫入模式建立磁碟，允許多個執行個體同時存取磁碟。

控制台

前往「VM instances」(VM 執行個體) 頁面。

前往 VM 執行個體
按一下您要為其新增磁碟的執行個體名稱。
在「VM instance details」(VM 執行個體詳細資料) 頁面中，按一下「Edit」(編輯)。
在「Storage」(儲存空間) 區段的「Additional disks」(其他磁碟) 下方，按一下「Add new disk」(新增磁碟)。
指定磁碟名稱，並視需要新增說明。
在「Disk source type」(磁碟來源類型) 下方，選擇磁碟的資料來源：
- 如要建立空白磁碟，請選取「空白磁碟」。
- 如要從映像檔建立磁碟，請按照下列步驟操作：
  1. 選取「圖片」。
  2. 在「來源映像檔」下方，選擇磁碟的來源映像檔。
- 如要從現有快照建立磁碟，請按照下列步驟操作：
  1. 視來源快照是標準快照、即時快照或封存快照，分別選取「快照」、「即時快照」或「封存快照」。
  2. 在「來源快照」下方，從清單中選取來源快照或即時快照。系統只會列出所選位置的快照。
- 如要從機器映像檔 (預先發布版) 中的特定磁碟建立磁碟，請按照下列步驟操作：
  
  預覽
  
  這項產品或功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前的產品和功能是按照「原樣」提供，支援範圍可能有限。詳情請參閱推出階段說明。
  1. 選取「Machine Image」。
  2. 在「Source machine image」(來源機器映像檔) 下拉式選單中，選取要使用的機器映像檔。
  3. 在「Source disk」(來源磁碟) 下拉式選單中，選取所選機器映像檔中特定磁碟的裝置名稱，做為新磁碟的來源。
  4. 如果所選機器映像檔受到客戶提供的加密金鑰 (CSEK) 保護 (已淘汰)，系統會顯示「Encryption」(加密) 部分。在提供的欄位中輸入必要的解密金鑰。
  5. 視需要設定其他磁碟屬性，例如「Name」(名稱)、「Type」(類型)、「Size」(大小)和「Deletion」(刪除) 規則。
在「磁碟設定」下方，從下列清單中選擇磁碟類型。指定的值必須在支援的值範圍內。
1. Hyperdisk Balanced。您也可以變更預設磁碟「Size」(大小)、「Provisioned IOPS」(佈建的 IOPS) 和「Provisioned Throughput」(佈建的處理量) 設定。
2. Hyperdisk Extreme。您也可以變更預設磁碟「大小」和「佈建 IOPS」設定。
3. Hyperdisk ML。您也可以變更預設磁碟大小和佈建輸送量設定。
4. Hyperdisk Throughput。您也可以變更預設磁碟大小和佈建輸送量設定。
選用：如要查看進階設定選項，請展開「顯示進階設定」部分。
- 在「Mode」(模式) 欄位中選取磁碟連接模式。
- 在「刪除規則」欄位中選取選項，即可選擇在刪除執行個體時保留或刪除磁碟。
- 如要更輕鬆地在客體 OS 中識別磁碟，請指定自訂裝置名稱。在「裝置名稱」標題下方，選取「使用自訂裝置名稱」選項。在「Device name」(裝置名稱) 欄位中，輸入要用做磁碟符號連結的字串。
按一下「完成」。
如要將變更套用至執行個體，請按一下「Save」(儲存)。

gcloud

使用 gcloud compute disks create 指令建立 Hyperdisk 磁碟區。
```
gcloud compute disks create DISK_NAME \
    --zone=ZONE \
    --size=DISK_SIZE \
    --type=DISK_TYPE \
    --provisioned-iops=IOPS_LIMIT \
    --provisioned-throughput=THROUGHPUT_LIMIT \
    --access-mode=DISK_ACCESS_MODE
```
更改下列內容：
- DISK_NAME：新磁碟的名稱。
- ZONE：建立新磁碟的可用區名稱。
- DISK_SIZE：選用：新磁碟的大小。值必須是整數，後面接著大小單位，例如 GB 代表十億位元組，TB 代表兆位元組。如未指定大小單位，則會使用 100 GB 做為預設值。可接受的磁碟大小值如下：
  - Hyperdisk Balanced：從 4 GiB 到 64 TiB (含)，以 1 GiB 為單位調整。
  - Hyperdisk Extreme：64 GiB 至 64 TiB (含)，以 1 GiB 為單位遞增。
  - Hyperdisk ML：4 GiB 至 64 TiB (含)，以 1 GiB 為單位遞增。
  - Hyperdisk Throughput：從 2 TiB 到 32 TiB (含)，以 1 GiB 為單位調整。
- DISK_TYPE：磁碟類型。請使用下列其中一個值：hyperdisk-balanced、hyperdisk-extreme、hyperdisk-ml 或 hyperdisk-throughput
- IOPS_LIMIT：選用：如果是 Hyperdisk Balanced 或 Hyperdisk Extreme 磁碟，這是指磁碟每秒可處理的 I/O 作業數 (IOPS)。
- THROUGHPUT_LIMIT：選用。如果是 Hyperdisk Balanced、Hyperdisk ML 或 Hyperdisk Throughput 磁碟區，這個整數代表磁碟可提供的最大處理量，單位為 MiB/秒。
- DISK_ACCESS_MODE：選用。運算執行個體如何存取磁碟上的資料。支援的值如下：
  - READ_WRITE_SINGLE，以便從一個執行個體進行讀寫存取。這是目前的預設做法。
  - READ_WRITE_MANY (僅限 Hyperdisk Balanced 和 Hyperdisk Balanced High Availability)，可供多個執行個體同時讀取/寫入。
  - (僅限 Hyperdisk ML)，可供多個執行個體同時唯讀存取。READ_ONLY_MANY
  如要設定 Hyperdisk Balanced High Availability 磁碟的存取模式，請參閱「建立區域性磁碟」。
選用：使用 gcloud compute disks describe DISK_NAME 指令查看磁碟說明。
建立磁碟後，即可將磁碟附加至執行個體。

REST

使用 disks.insert 方法建構 POST 要求，建立可用區 Hyperdisk。加入 name、sizeGb、type、provisionedIops 和 provisionedThroughput 屬性。如要建立空白且未格式化的非開機磁碟，請勿指定來源映像檔或來源快照。
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks
{
   "name": "DISK_NAME",
   "sizeGb": "DISK_SIZE",
   "type": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE",
   "provisionedIops": "IOPS_LIMIT",
   "provisionedThroughput": "THROUGHPUT_LIMIT",
   "accessMode": "DISK_ACCESS_MODE"
}
```
更改下列內容：
- PROJECT_ID：專案 ID
- ZONE：執行個體和新磁碟所在的可用區
- DISK_NAME：新磁碟的名稱
- DISK_SIZE：選用：新磁碟的大小。值必須是整數，後面加上大小單位 GB (gibibytes) 或 TB (tebibytes)。
- DISK_TYPE：磁碟類型。如要建立 Hyperdisk 磁碟區，請使用下列其中一個值：hyperdisk-balanced、hyperdisk-extreme、hyperdisk-ml 或 hyperdisk-throughput。
- IOPS_LIMIT：選用：如果是 Hyperdisk Balanced 和 Hyperdisk Extreme，這是磁碟每秒可處理的 I/O 作業數。
- THROUGHPUT_LIMIT：選用：如果是 Hyperdisk Balanced、Hyperdisk ML 或 Hyperdisk Throughput 磁碟區，這是代表磁碟可提供的最大輸送量的整數，單位為 MiB/秒。
- DISK_ACCESS_MODE：選用：運算執行個體如何存取磁碟上的資料。支援的值如下：
  - READ_WRITE_SINGLE：可從一個執行個體讀取/寫入。這是目前的預設做法。
  - READ_WRITE_MANY，(僅限 Hyperdisk Balanced 和 Hyperdisk Balanced High Availability) 可供多個執行個體同時讀寫存取。
  - READ_ONLY_MANY，(僅限 Hyperdisk ML) 可供多個執行個體同時進行唯讀存取。
  如要設定 Hyperdisk Balanced High Availability 磁碟的存取模式，請參閱「建立區域性磁碟」。
選用：使用 compute.disks.get 方法查看磁碟說明。
建立磁碟後，您可以將磁碟連結至任何正在執行或已停止的執行個體。

Go

// createHyperdisk creates a new Hyperdisk in the specified project and zone.
func createHyperdisk(w io.Writer, projectId, zone, diskName string) error {
	//   projectID := "your_project_id"
	//   zone := "europe-central2-b"
	//   diskName := "your_disk_name"

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

	// use format "zones/{zone}/diskTypes/(hyperdisk-balanced|hyperdisk-throughput)".
	diskType := fmt.Sprintf("zones/%s/diskTypes/hyperdisk-balanced", zone)

	// Create the disk
	disk := &computepb.Disk{
		Name:   proto.String(diskName),
		Type:   proto.String(diskType),
		SizeGb: proto.Int64(10),
		Zone:   proto.String(zone),
	}

	req := &computepb.InsertDiskRequest{
		Project:      projectId,
		Zone:         zone,
		DiskResource: disk,
	}

	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, "Hyperdisk created: %v\n", diskName)
	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 CreateHyperdisk {
  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";
    // The type of disk you want to create. This value uses the following format:
    // "zones/{zone}/diskTypes/{disktype}".
    // disktype is one of hyperdisk-balanced, hyperdisk-extreme, hyperdisk-throughput
    // hyperdisk-ml, hyperdisk-balanced-high-availability
    // 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: For Hyperdisk Balanced or Hyperdisk Extreme disks,
    // this is the number of I/O operations per second (IOPS) that the disk can handle
    long 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.
    long provisionedThroughput = 140;

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

  // Creates a hyperdisk in a project
  public static Disk createHyperdisk(String projectId, String zone, String diskName,
                                     String diskType, long diskSizeGb, long provisionedIops,
                                     long provisionedThroughput)
          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)
              .setProvisionedIops(provisionedIops)
              .setProvisionedThroughput(provisionedThroughput)
              .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 = 'europe-central2-b';

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

// 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 callCreateComputeHyperdisk() {
  // Create a disk
  const disk = new compute.Disk({
    sizeGb: diskSizeGb,
    name: diskName,
    zone,
    type: diskType,
    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 callCreateComputeHyperdisk();

建立磁碟後，您可以將磁碟附加至任何執行中或已停止的執行個體。

格式化及掛接磁碟

建立新磁碟並連接至執行個體後，您必須格式化並掛接磁碟，作業系統才能使用可用儲存空間。

Linux：請參閱「在 Linux 運算執行個體上格式化及掛接非開機磁碟」
Windows：請參閱在 Windows Compute 執行個體上格式化及掛接非開機磁碟

後續步驟

瞭解如何自訂 Hyperdisk 磁碟區的 IOPS 和處理量。
瞭解如何使用快照定期備份磁碟，避免資料意外遺失。

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

事前準備

控制台

gcloud

Go

Java

Node.js

REST

所需角色和權限

所需權限

Hyperdisk 磁碟區支援的值

Hyperdisk 的大小限制和參照名稱

效能限制

在執行個體中新增 Hyperdisk 磁碟區

控制台

gcloud

REST

Go

Java

Node.js

格式化及掛接磁碟

後續步驟

建立新的 Hyperdisk 磁碟區