Mengelola Penyimpanan Gabungan Hyperdisk

Dokumen ini menjelaskan cara mencantumkan, mendeskripsikan, mengubah, dan menghapus kumpulan penyimpanan.

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda agar dapat mengakses Google Cloud layanan dan API. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi 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

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Untuk informasi selengkapnya, lihat Mengautentikasi untuk menggunakan REST dalam Google Cloud dokumentasi autentikasi.

Peran dan izin yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengelola kumpulan penyimpanan, minta administrator untuk memberi Anda peran IAM berikut pada project:

  • Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1)
  • Untuk terhubung ke instance VM yang dapat dijalankan sebagai akun layanan: Service Account User (v1) (peran 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 mengelola kumpulan penyimpanan. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengelola kumpulan penyimpanan:

  • Untuk mencantumkan kumpulan penyimpanan untuk project dan zona: compute.storagePools.list
  • Untuk mencantumkan disk dalam kumpulan penyimpanan: compute.storagePools.get
  • Untuk melihat properti kumpulan penyimpanan: compute.storagePools.get
  • Untuk memperbarui kapasitas atau performa penyimpanan gabungan yang disediakan:
    • compute.storagePools.get
    • compute.storagePools.update
  • Untuk menghapus kumpulan penyimpanan: compute.storagePools.delete

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

Batasan

Perhatikan batasan berikut saat mengelola Penyimpanan Gabungan Hyperdisk:

  • Anda dapat mengubah kapasitas atau performa yang disediakan dari kumpulan penyimpanan maksimal dua kali dalam periode 24 jam.
  • Anda tidak dapat mengubah model penyediaan untuk kumpulan; Anda tidak dapat mengubah kumpulan penyimpanan kapasitas Standar menjadi kumpulan penyimpanan kapasitas Lanjutan atau kumpulan penyimpanan performa Lanjutan menjadi kumpulan penyimpanan performa Standar.
  • Memindahkan disk ke dalam atau keluar dari kumpulan penyimpanan tidak diizinkan. Untuk memindahkan disk ke dalam atau ke luar kumpulan penyimpanan, Anda harus membuat ulang disk dari snapshot. Untuk mengetahui informasi selengkapnya, lihat Mengubah jenis disk.
  • Anda tidak dapat meng-clone, membuat snapshot instan, atau mengonfigurasi Replikasi Asinkron Persistent Disk untuk disk dalam kumpulan penyimpanan.
  • Anda dapat menghapus maksimal 5 kumpulan penyimpanan per jam.
  • Perintah pengelolaan kumpulan penyimpanan berhasil atau gagal segera, tetapi perlu waktu hingga 5 menit untuk menyelesaikan tindakan, dan hingga 30 menit agar perubahan muncul.

Untuk daftar lengkap batasan Penyimpanan Gabungan Hyperdisk, lihat Batasan penyimpanan gabungan.

Rentang nilai saat mengubah penyimpanan

Saat membuat kumpulan penyimpanan, nilai baru untuk ukuran, IOPS, dan throughput harus berada dalam batas untuk jenis kumpulan penyimpanan yang Anda ubah. Selain itu, Anda hanya dapat menentukan nilai baru menggunakan nilai inkremental yang didukung.

Untuk batas penyediaan performa yang mendetail, lihat Batas untuk kumpulan penyimpanan.

Mencantumkan kumpulan penyimpanan untuk project

Untuk melihat penyimpanan pool yang dibuat dalam project, gunakan konsol Google Cloud, Google Cloud CLI, atau REST.

Konsol

  1. Buka halaman Storage pool di konsol Google Cloud.
    Buka halaman Storage pools

    Halaman ini menampilkan kumpulan penyimpanan yang dibuat dalam project yang dipilih.

  2. Opsional: Gunakan panel Filter untuk hanya menampilkan kumpulan penyimpanan yang cocok dengan parameter filter, seperti Lokasi, Jenis, Nama, dan Ketersediaan kapasitas kumpulan.

gcloud

Untuk mencantumkan semua storage pool yang dibuat dalam project saat ini, gunakan perintah gcloud compute storage-pools list.

gcloud compute storage-pools list

Untuk membatasi hasil ke region atau zona tertentu, Anda dapat menggunakan flag --filter, misalnya:

  • --filter="zone ~ us
  • --filter="zone=us-east4-c"

REST

Untuk menampilkan kumpulan penyimpanan yang dibuat dalam project dan zona, buat permintaan GET menggunakan metode storagePools.list.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools

Ganti kode berikut:

  • PROJECT_ID: ID project yang berisi penyimpanan pool
  • ZONE: zona tempat penyimpanan berada, misalnya, us-central1-a.

Mencantumkan disk dalam kumpulan penyimpanan

Untuk mendapatkan daftar disk yang dibuat di storage pool, gunakan Konsol Google Cloud, Google Cloud CLI, atau REST.

Konsol

  1. Buka halaman Storage pool di konsol Google Cloud.
    Buka halaman Storage pools

    Halaman ini menampilkan kumpulan penyimpanan yang dibuat dalam project yang dipilih.

  2. Di kolom Name, klik nama storage pool yang ingin Anda lihat.

    Halaman Kelola kumpulan penyimpanan akan terbuka.

  3. Di bagian Storage pool disks, Anda dapat melihat disk yang dibuat di storage pool.

gcloud

Untuk mencantumkan disk yang dibuat di kumpulan penyimpanan, gunakan perintah gcloud compute storage-pools list-disks.

gcloud compute storage-pools list-disks STORAGE_POOL_NAME  \
    [--zone=ZONE]

Ganti kode berikut:

  • STORAGE_POOL_NAME: nama penyimpanan pool.
  • ZONE: Opsional. Zona tempat kumpulan penyimpanan berada, misalnya, us-central1-a.

REST

Untuk mencantumkan disk yang menggunakan kumpulan penyimpanan, buat permintaan GET menggunakan metode storagePools.listDisks.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME/listDisks

Ganti kode berikut:

  • PROJECT_ID: ID project yang berisi penyimpanan pool
  • ZONE: zona tempat penyimpanan berada, misalnya, us-central1-a.
  • STORAGE_POOL_NAME: nama penyimpanan pool.

Menjelaskan penyimpanan bersama

Untuk melihat detail penyimpanan, Anda dapat menggunakan konsol Google Cloud, Google Cloud CLI, atau REST.

Konsol

  1. Buka halaman Storage pool di konsol Google Cloud.
    Buka halaman Storage pools

  2. Untuk setiap kumpulan penyimpanan yang tercantum di halaman, Anda dapat melihat informasi berikut:

    • Status
    • Nama
    • Lokasi
    • Jenis kolam
    • Kapasitas gabungan
    • Kapasitas gabungan yang tersisa
    • IOPS Tampungan
    • IOPS yang tersisa di kumpulan
    • Jumlah disk yang dibuat dalam kumpulan

  3. Di kolom Name, klik nama storage pool yang ingin Anda lihat.

    Halaman Kelola kumpulan penyimpanan akan terbuka.

  4. Pada kartu di bagian atas halaman, Anda dapat melihat kapasitas yang disediakan dan digunakan, serta throughput dan IOPS yang disediakan dan digunakan untuk penyimpanan gabungan.

  5. Di bagian Setelan penyimpanan gabungan, Anda dapat melihat properti tambahan penyimpanan gabungan, seperti waktu pembuatan, jenis penyediaan kapasitas, jenis penyediaan performa, jumlah total disk dalam penyimpanan gabungan, dan persentase penggunaan untuk kapasitas, throughput, dan IOPS.

  6. Di bagian Disk penyimpanan, Anda dapat melihat informasi tentang disk yang dibuat di penyimpanan.

  7. Opsional: Untuk informasi tambahan tentang penggunaan penyimpanan gabungan, Anda dapat mengklik tab Monitoring untuk melihat grafik berbagai metrik penyimpanan gabungan. Untuk mengetahui informasi selengkapnya, lihat Memantau Penyimpanan Gabungan Hyperdisk.

gcloud

Gunakan perintah gcloud compute storage-pools describe untuk melihat detail penyimpanan.

gcloud compute storage-pools describe STORAGE_POOL_NAME  \
    [--zone=ZONE]

Ganti kode berikut:

  • STORAGE_POOL_NAME: nama kumpulan penyimpanan unik.
  • ZONE: Opsional. Zona tempat kumpulan penyimpanan berada, misalnya, us-central1-a.

REST

Untuk mengambil detail tentang kumpulan penyimpanan, buat permintaan GET menggunakan metode storagePools.get.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

Ganti kode berikut:

  • PROJECT_ID: ID project yang berisi storage pool
  • ZONE: zona tempat kumpulan penyimpanan berada, misalnya, us-central1-a
  • STORAGE_POOL_NAME: nama penyimpanan pool

Memperbarui kapasitas, IOPS, atau throughput yang disediakan untuk penyimpanan gabungan

Anda dapat meningkatkan atau menurunkan kapasitas, IOPS, atau throughput yang disediakan penyimpanan gabungan. Untuk meningkatkan kapasitas, IOPS, atau throughput kumpulan penyimpanan, Anda harus memiliki kuota yang tersedia untuk project dan region.

Konsol

  1. Buka halaman Storage pool di konsol Google Cloud.
    Buka halaman Storage pools

  2. Di kolom Name, klik nama storage pool yang ingin Anda ubah.

    Halaman Kelola kumpulan penyimpanan akan terbuka.

  3. Klik Edit.

    Halaman Edit storage pool akan terbuka.

  4. Opsional: Di kolom Storage pool capacity, masukkan nilai baru untuk kapasitas yang disediakan oleh pool. Nilai baru harus minimal 1 TiB dan maksimal 100 TiB lebih atau kurang dari nilai saat ini. Ukuran minimum tidak boleh kurang dari 10 TiB dan ukuran maksimum tidak boleh lebih dari 1.024 TiB.

  5. Opsional: Di kolom Provisioned throughput, masukkan nilai baru untuk throughput yang disediakan.

  6. Opsional: Untuk storage pool jenis Hyperdisk Balanced, di kolom Provisioned IOPS, masukkan nilai baru untuk IOPS yang disediakan.

  7. Klik Simpan untuk memperbarui kumpulan penyimpanan.

gcloud

Gunakan perintah gcloud compute storage-pools update untuk mengubah penyimpanan.

gcloud compute storage-pools update STORAGE_POOL_NAME  \
    --zone=ZONE   \
    --provisioned-capacity=POOL_SIZETiB   \
    --provisioned-iops=IOPS   \
    --provisioned-throughput=THROUGHPUT   \
    --description=DESCRIPTION

Ganti kode berikut:

  • STORAGE_POOL_NAME: nama penyimpanan pool.
  • ZONE: Opsional: zona tempat kumpulan penyimpanan berada, misalnya, us-central1-a.
  • POOL_SIZE: Opsional: kapasitas penyimpanan bersama yang disediakan, dalam TiB.
  • IOPS: Opsional: IOPS yang disediakan oleh storage pool. Anda hanya dapat menggunakan flag ini dengan Hyperdisk Balanced Storage Pool.
  • THROUGHPUT: Opsional: throughput yang disediakan kumpulan penyimpanan, dalam MBps.
  • DESCRIPTION: Opsional: string deskriptif untuk kumpulan penyimpanan.

REST

Untuk memperbarui kumpulan penyimpanan, buat permintaan PATCH menggunakan metode storagePools.update.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

{
    "description": "DESCRIPTION",
    "poolProvisionedCapacityGb": "SIZE",
    "poolProvisionedIops": "IOPS",
    "poolProvisionedThroughput": "THROUGHPUT"
}

Ganti kode berikut:

  • PROJECT_ID: the project ID
  • ZONE: zona tempat penyimpanan berada, misalnya, us-central1-a.
  • STORAGE_POOL_NAME: nama penyimpanan pool.
  • DESCRIPTION: Opsional: kolom teks untuk mendeskripsikan kumpulan penyimpanan.
  • SIZE: Opsional: kapasitas kumpulan penyimpanan baru yang disediakan, dalam GiB.
  • IOPS: Opsional: nilai baru untuk IOPS yang disediakan kumpulan penyimpanan. Anda hanya dapat menentukan properti ini jika storage pool berisi disk jenis hyperdisk-balanced.
  • THROUGHPUT: Opsional: nilai baru untuk throughput yang disediakan kumpulan penyimpanan, yang ditentukan dalam MBps.

Menghapus penyimpanan bersama

Untuk menghapus atau menghapus penyimpanan bersama, Anda harus menghapus semua disk dalam penyimpanan bersama terlebih dahulu. Kemudian, Anda dapat menggunakan konsol Google Cloud, Google Cloud CLI, atau REST untuk menghapus penyimpanan.

Penghapusan kumpulan penyimpanan tidak dapat dibatalkan. Namun, menghapus kumpulan penyimpanan tidak akan menghapus snapshot apa pun yang dibuat dari disk yang dibuat di kumpulan penyimpanan. Anda harus menghapus snapshot secara terpisah.

Konsol

  1. Buka halaman Storage Pool di konsol Google Cloud.
    Buka halaman Storage Pool

  2. Di kolom Name, klik nama storage pool yang ingin Anda hapus.

    Halaman Kelola kumpulan penyimpanan akan terbuka.

  3. Di bagian Storage pool disks, pastikan tidak ada disk yang tercantum untuk storage pool.

  4. Klik Hapus pool.

gcloud

Gunakan perintah gcloud compute storage-pools delete untuk menghapus storage pool.

gcloud compute storage-pools delete STORAGE_POOL_NAME  \
    --zone=ZONE   \

Ganti kode berikut:

  • STORAGE_POOL_NAME: nama kumpulan penyimpanan unik.
  • ZONE: Opsional: zona tempat kumpulan penyimpanan berada, misalnya, us-central1-a.

REST

Untuk menghapus kumpulan penyimpanan, buat permintaan DELETE untuk metode storagePools.delete.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

Ganti kode berikut:

  • PROJECT_ID: the project ID
  • ZONE: zona tempat penyimpanan berada, misalnya, us-central1-a.
  • STORAGE_POOL_NAME: nama kumpulan penyimpanan unik.

Apa langkah selanjutnya?