Halaman ini diterjemahkan oleh Cloud Translation API.

Membuat volume Hyperdisk baru

Anda dapat menggunakan volume Hyperdisk Seimbang, Hyperdisk Ekstrem, atau Hyperdisk Throughput dengan instance Compute Engine Anda dengan menyelesaikan tugas berikut:

Buat volume Hyperdisk kosong, non-booting, dan zona, lalu sertakan ke instance Anda selama atau setelah pembuatan instance.
Memformat dan memasang volume untuk memberikan akses ke data atau sistem file.

Untuk volume Hyperdisk Balanced, Anda juga dapat membuat boot disk serta disk data.

Untuk mengetahui informasi umum tentang Hyperdisk, lihat Tentang Hyperdisk.

Untuk menambahkan disk Hyperdisk Balanced High Availability ke instance Anda, gunakan prosedur berikut:

Sebelum memulai

Tinjau Batasan Hyperdisk sebelum menambahkan volume Hyperdisk ke instance komputasi Anda.
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

Peran dan izin yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menambahkan volume Hyperdisk ke instance Anda, minta administrator untuk memberi Anda peran IAM berikut pada project:

Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1)
Untuk terhubung ke instance yang dapat dijalankan sebagai akun layanan: Service Account User (v1) (roles/iam.serviceAccountUser)

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk menambahkan volume Hyperdisk ke instance Anda. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk menambahkan volume Hyperdisk ke instance Anda:

Untuk membuat dan menyertakan volume Hyperdisk:
- compute.disks.create dalam project
- compute.instances.attachDisk di instance
- compute.disks.use di volume yang ingin Anda sertakan ke instance
Untuk memformat dan memasang volume yang terpasang: compute.instances.setMetadata di instance

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Nilai yang didukung untuk volume Hyperdisk

Batas ukuran

Ukuran yang Anda tentukan untuk volume Hyperdisk harus berada dalam rentang yang tercantum dalam tabel berikut.

Jenis Hyperdisk	Ukuran minimum	Ukuran maksimum	Ukuran default
Hyperdisk Balanced	4 GiB	64 TiB	100 GiB
Hyperdisk Balanced High Availability	4 GiB	64 TiB	100 GiB
Ekstrem Hyperdisk	64 GiB	64 TiB	1 TiB
Hyperdisk ML	4 GiB	64 TiB	100 GiB
Hyperdisk Throughput	2 TiB	32 TiB	2 TiB

Namun, ukuran volume Hyperdisk yang terpasang ke VM tidak boleh melebihi batas Hyperdisk untuk VM.

Batas performa

Tabel berikut mencantumkan batas performa yang dapat Anda tentukan untuk setiap jenis Hyperdisk. Namun, level IOPS dan throughput yang dapat Anda tentukan juga bergantung pada ukuran volume. Untuk ringkasan mendetail setiap batas, lihat bagian Batas ukuran dan performa untuk Hyperdisk Seimbang, Hyperdisk Seimbang dengan Ketersediaan Tinggi, Hyperdisk Ekstrem, Hyperdisk ML, dan Hyperdisk Throughput.

Jenis Hyperdisk	Batas IOPS	Batas throughput (MiB/dtk)
Hyperdisk Balanced	160.000	2.400
Hyperdisk Balanced High Availability	100.000	1.200
Ekstrem Hyperdisk	350.000	Anda tidak dapat menyediakan tingkat throughput untuk volume Hyperdisk Extreme. Setiap volume mendapatkan throughput 250 MiB/dtk dengan setiap 1.000 IOPS, hingga 5.000 MiB/dtk.
Hyperdisk ML	Anda tidak dapat menyediakan level IOPS, tetapi setiap MiB/dtk throughput yang disediakan dilengkapi dengan 16 IOPS, hingga 19.200.000 IOPS.	1.200.000
Hyperdisk Throughput	Anda tidak dapat menyediakan tingkat IOPS, tetapi setiap MiB/dtk throughput yang disediakan dilengkapi dengan 4 IOPS, hingga 2.400 IOPS.	600

Variabel jenis Hyperdisk

Tabel berikut mencantumkan nilai referensi setiap jenis Hyperdisk. Saat membuat volume Hyperdisk dengan Google Cloud CLI, REST, atau Cloud Client Libraries untuk Compute Engine, tunjukkan jenis Hyperdisk yang akan dibuat dengan memberikan nilai yang sesuai dari tabel.

Jenis disk	Nama referensi
Hyperdisk Balanced	`hyperdisk-balanced`
Hyperdisk Balanced High Availability	`hyperdisk-balanced-high-availability`
Ekstrem Hyperdisk	`hyperdisk-extreme`
Hyperdisk Throughput	`hyperdisk-throughput`
Hyperdisk ML	`hyperdisk-ml`

Menambahkan volume Hyperdisk ke instance Anda

Anda dapat membuat dan melampirkan volume Hyperdisk menggunakan konsolGoogle Cloud , Google Cloud CLI, atau REST.

Ukuran, throughput, dan IOPS yang Anda tentukan saat membuat volume Hyperdisk harus berada dalam rentang nilai yang didukung.

Saat membuat volume Hyperdisk Seimbang, Anda dapat secara opsional mengizinkan beberapa instance mengakses disk secara bersamaan dengan membuat disk dalam mode multi-penulis.

Konsol

Buka halaman VM instances.

Buka instance VM
Klik nama instance tempat Anda ingin menambahkan disk.
Di halaman VM instance details, klik Edit.
Di bagian judul Disk tambahan, klik Tambahkan disk baru.
Tentukan nama untuk disk, dan jika perlu, tambahkan deskripsi. Pilih Disk kosong sebagai Jenis sumber disk.
Di bagian Setelan disk, pilih jenis disk dari daftar berikut. Nilai yang Anda tentukan harus berada dalam rentang nilai yang didukung.
1. Hyperdisk Balanced. Anda juga dapat mengubah setelan Ukuran disk default, IOPS yang Disediakan, dan Throughput yang Disediakan.
2. Hyperdisk Ekstrem. Anda juga dapat mengubah setelan Ukuran disk default dan IOPS yang Disediakan.
3. Hyperdisk ML. Anda juga dapat mengubah setelan Ukuran disk default dan Throughput yang Disediakan.
4. Throughput Hyperdisk. Anda juga dapat mengubah setelan Ukuran disk default dan Throughput yang Disediakan.
Opsional: Untuk volume Hyperdisk Seimbang, Anda dapat mengaktifkan pemasangan disk ke beberapa instance dengan membuat disk dalam mode multi-penulis. Di bagian Mode akses, pilih Baca tulis beberapa VM.
Klik Simpan.
Untuk menerapkan perubahan pada instance, klik Simpan.

gcloud

Gunakan perintah gcloud compute disks create untuk membuat volume 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
```
Ganti kode berikut:
- DISK_NAME: nama disk baru.
- ZONE: nama zona tempat disk baru dibuat.
- DISK_SIZE: Opsional: Ukuran disk baru. Nilai harus berupa bilangan bulat yang diikuti dengan unit ukuran GB untuk gibibyte, atau TB untuk tebibyte. Jika tidak ada unit ukuran yang ditentukan, 100 GB akan digunakan sebagai nilai default. Nilai yang diterima untuk ukuran disk adalah:
  - Hyperdisk Seimbang: Dari 4 GiB hingga 64 TiB, inklusif, dengan kenaikan 1 GiB.
  - Hyperdisk Ekstrem: Dari 64 GiB hingga 64 TiB, inklusif, dengan kelipatan 1 GiB.
  - Hyperdisk ML: Dari 4 GiB hingga 64 TiB, inklusif, dengan kenaikan 1 GiB.
  - Throughput Hyperdisk: Dari 2 TiB hingga 32 TiB, inklusif, dengan kenaikan 1 GiB.
- DISK_TYPE: jenis disk. Gunakan salah satu nilai berikut: hyperdisk-balanced, hyperdisk-extreme, hyperdisk-ml, atau hyperdisk-throughput
- IOPS_LIMIT: Opsional: Untuk disk Hyperdisk Balanced atau Hyperdisk Extreme, ini adalah jumlah operasi I/O per detik (IOPS) yang dapat ditangani disk.
- THROUGHPUT_LIMIT: Opsional: Untuk volume Hyperdisk Seimbang, Hyperdisk ML, atau Hyperdisk Throughput, ini adalah bilangan bulat yang mewakili throughput maksimum, yang diukur dalam MiB per detik, yang dapat disediakan oleh disk.
- DISK_ACCESS_MODE: Opsional: Cara instance komputasi dapat mengakses data di disk. Nilai yang didukung adalah:
  - READ_WRITE_SINGLE, untuk akses baca-tulis dari satu instance. Ini adalah setelan defaultnya.
  - READ_WRITE_MANY, (khusus Hyperdisk Balanced dan Hyperdisk Balanced High Availability) untuk akses baca-tulis serentak dari beberapa instance.
  - READ_ONLY_MANY, (khusus Hyperdisk ML) untuk akses baca saja serentak dari beberapa instance.
  Untuk menyetel mode akses untuk disk Hyperdisk Balanced High Availability, lihat Membuat disk regional.
Opsional: Gunakan perintah gcloud compute disks describe DISK_NAME untuk melihat deskripsi disk Anda.
Setelah membuat disk, Anda dapat memasang disk ke instance.

REST

Buat permintaan POST untuk membuat Hyperdisk zonal menggunakan metode disks.insert. Sertakan properti name, sizeGb, type, provisionedIops, dan provisionedThroughput. Untuk membuat disk ini sebagai disk non-boot kosong dan tidak terformat, jangan tentukan image sumber atau snapshot sumber.
```
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"
}
```
Ganti kode berikut:
- PROJECT_ID: project ID Anda
- ZONE: zona tempat instance dan disk baru berada
- DISK_NAME: nama disk baru
- DISK_SIZE: Opsional: Ukuran disk baru. Nilainya harus berupa bilangan bulat yang diikuti dengan unit ukuran GB untuk gibibyte atau TB untuk tebibyte.
- DISK_TYPE: jenis disk. Untuk membuat volume Hyperdisk, gunakan salah satu nilai berikut: hyperdisk-balanced, hyperdisk-extreme, hyperdisk-ml, atau hyperdisk-throughput.
- IOPS_LIMIT: Opsional: Untuk Hyperdisk Balanced dan Hyperdisk Extreme, ini adalah jumlah operasi I/O per detik yang dapat ditangani disk.
- THROUGHPUT_LIMIT: Opsional: Untuk volume Hyperdisk Seimbang, Hyperdisk ML, atau Hyperdisk Throughput, ini adalah bilangan bulat yang mewakili throughput maksimum, yang diukur dalam MiB per detik, yang dapat disediakan oleh disk.
- DISK_ACCESS_MODE: Opsional: Cara instance komputasi dapat mengakses data di disk. Nilai yang didukung adalah:
  - READ_WRITE_SINGLE, untuk akses baca-tulis dari satu instance. Ini adalah setelan defaultnya.
  - READ_WRITE_MANY, (khusus Hyperdisk Balanced dan Hyperdisk Balanced High Availability) untuk akses baca-tulis serentak dari beberapa instance.
  - READ_ONLY_MANY, (khusus Hyperdisk ML) untuk akses hanya baca serentak dari beberapa instance.
  Untuk menyetel mode akses untuk disk Hyperdisk Balanced High Availability, lihat Membuat disk regional.
Opsional: Gunakan metode compute.disks.get untuk melihat deskripsi disk Anda.
Setelah membuat disk, Anda dapat melampirkan disk ke instance yang sedang berjalan atau dihentikan.

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/(hyperdisk-balanced|hyperdisk-extreme|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: 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();

Setelah membuat disk, Anda dapat melampirkan disk ke instance yang sedang berjalan atau dihentikan.

Memformat dan memasang disk

Setelah membuat dan memasang disk baru ke instance, Anda harus memformat dan memasang disk, sehingga sistem operasi dapat menggunakan ruang penyimpanan yang tersedia.

Linux: Lihat Memformat dan memasang non-boot disk di instance komputasi Linux
Windows: Lihat Memformat dan memasang non-boot disk pada instance komputasi Windows

Langkah berikutnya

Pelajari cara menyesuaikan IOPS dan throughput pada volume Hyperdisk Anda.
Pelajari cara mencadangkan disk menggunakan snapshot secara rutin untuk mencegah kehilangan data yang tidak diinginkan.

Membuat volume Hyperdisk baru Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Console

gcloud

Go

Java

Node.js

REST

Peran dan izin yang diperlukan

Izin yang diperlukan

Nilai yang didukung untuk volume Hyperdisk

Batas ukuran

Batas performa

Variabel jenis Hyperdisk

Menambahkan volume Hyperdisk ke instance Anda

Konsol

gcloud

REST

Go

Java

Node.js

Memformat dan memasang disk

Langkah berikutnya

Membuat volume Hyperdisk baru