Mengelola kumpulan Hyperdisk

Dokumen ini menjelaskan cara mencantumkan, menjelaskan, mengubah, dan menghapus pool Hyperdisk.

Sebelum memulai

  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    Konsol

    Saat menggunakan konsol Google Cloud untuk mengakses layanan Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  • Tetapkan region dan zona default.

    • REST

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

      Instal Google Cloud CLI.

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

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

Peran dan izin yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengelola kumpulan, minta administrator Anda untuk memberi Anda peran IAM berikut di 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 pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk mengelola kumpulan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengelola kumpulan:

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

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

Batasan

Batasan untuk mengelola pool:

  • Anda tidak dapat mengubah model penyediaan untuk pool. Misalnya, Anda tidak dapat mengubah Penyimpanan Gabungan berkapasitas Standar menjadi Penyimpanan Gabungan berkapasitas Lanjutan atau Penyimpanan Gabungan berperforma Lanjutan menjadi Penyimpanan Gabungan berperforma Standar.
  • Anda tidak dapat memindahkan disk ke dalam atau ke luar pool. Untuk memindahkan disk ke dalam atau ke luar pool, Anda harus membuat ulang disk dari snapshot. Untuk mengetahui informasi selengkapnya, lihat Mengubah jenis disk.
  • Anda tidak dapat meng-clone, membuat snapshot instan dari, atau mengonfigurasi Replikasi Asinkron untuk disk dalam pool.

Batasan khusus untuk Kumpulan Penyimpanan:

  • Anda dapat mengubah kapasitas atau performa yang disediakan untuk Kumpulan Penyimpanan maksimal dua kali dalam periode 24 jam.
  • Anda dapat menghapus maksimal 5 Kumpulan Penyimpanan per jam.
  • Perintah pengelolaan Kumpulan Penyimpanan akan berhasil atau gagal segera, tetapi tindakan ini dapat memerlukan waktu hingga 5 menit untuk diselesaikan, dan hingga 30 menit agar perubahan muncul.

Batasan khusus untuk Exapools:

  • Anda harus menghubungi tim akun untuk mengubah kapasitas, IOPS, atau throughput yang disediakan dari Exapool.
  • Anda harus menghubungi tim akun Anda untuk menghapus Exapool.

Untuk daftar lengkap batasan, lihat Batasan Kumpulan Penyimpanan dan Batasan Exapools.

Rentang nilai saat mengubah pool

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 dan Batas ukuran dan performa untuk Exapools.

Mencantumkan kumpulan untuk project

Untuk melihat kumpulan yang dibuat dalam project, gunakan konsolGoogle Cloud , Google Cloud CLI, atau REST.

Konsol

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

  2. Pilih tab untuk Exapools atau Storage Pools.

    Halaman ini menampilkan kumpulan yang dibuat dalam project yang dipilih.

  3. Opsional: Gunakan kolom Filter untuk menampilkan hanya kumpulan yang cocok dengan parameter filter, seperti Lokasi, Jenis, Nama, dan Kapasitas kumpulan yang tersisa.

gcloud

Untuk mencantumkan semua kumpulan 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 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 pool penyimpanan
  • ZONE: zona tempat pool berada, misalnya, us-central1-a.

Mencantumkan disk dalam pool

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

Konsol

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

  2. Pilih tab untuk Exapools atau Storage Pools.

    Halaman ini menampilkan kumpulan yang dibuat dalam project yang dipilih.

  3. Di kolom Nama, klik nama kumpulan yang ingin Anda lihat.

    Halaman Manage storage pool akan terbuka.

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

gcloud

Untuk mencantumkan disk yang dibuat di pool, 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 pool.
  • ZONE: Opsional. Zona tempat pool berada, misalnya, us-central1-a.

REST

Untuk mencantumkan disk yang menggunakan pool, 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 pool penyimpanan
  • ZONE: zona tempat pool berada, misalnya, us-central1-a.
  • STORAGE_POOL_NAME: nama pool.

Menjelaskan pool

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

Konsol

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

  2. Pilih tab untuk Exapools atau Storage Pools.

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

    • Status
    • Nama
    • Lokasi
    • Jenis kolam renang
    • Kapasitas gabungan
    • Kapasitas gabungan yang tersisa
    • IOPS Kumpulan
    • IOPS pool yang tersisa
    • Jumlah disk yang dibuat di pool

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

    Halaman Manage storage pool akan terbuka.

  5. Di kartu di bagian atas halaman, Anda dapat melihat kapasitas yang disediakan dan digunakan, serta throughput dan IOPS yang disediakan dan digunakan untuk pool.

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

  7. Di bagian Storage pool disks, Anda dapat melihat informasi tentang disk yang dibuat di pool.

  8. Opsional: Untuk informasi tambahan tentang penggunaan pool, Anda dapat mengklik tab Monitoring untuk melihat grafik berbagai metrik pool. Untuk mengetahui informasi selengkapnya, lihat Memantau kumpulan.

gcloud

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

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

Ganti kode berikut:

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

REST

Untuk mengambil detail tentang kumpulan, 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 pool
  • ZONE: zona tempat pool berada, misalnya, us-central1-a
  • STORAGE_POOL_NAME: nama pool

Mengubah pool

Anda dapat menambah atau mengurangi kapasitas, IOPS, atau throughput yang disediakan dari kumpulan.

Mengubah Kumpulan Penyimpanan

Untuk meningkatkan kapasitas, IOPS, atau throughput Penyimpanan Gabungan, Anda harus memiliki kuota yang tersedia untuk project dan region. Diperlukan waktu hingga 30 menit sebelum nilai penyediaan baru ditampilkan untuk Kumpulan Penyimpanan.

Konsol

  1. Buka halaman Storage pools di konsol Google Cloud .
    Buka halaman Storage pools
  2. Pilih tab Storage Pools.

  3. Di kolom Name, klik nama Storage Pool yang ingin Anda ubah.

    Halaman Manage storage pool akan terbuka.

  4. Klik Edit.

    Halaman Edit storage pool akan terbuka.

  5. Opsional: Di kolom Kapasitas pool penyimpanan, masukkan nilai baru untuk kapasitas yang disediakan pool. Nilai baru harus berbeda dari nilai saat ini minimal 1 TiB dan tidak lebih dari 100 TiB. Nilai baru dapat lebih besar atau lebih kecil daripada nilai saat ini. Ukuran minimum tidak boleh kurang dari 10 TiB dan ukuran maksimum tidak boleh lebih dari 5 PiB.

  6. Opsional: Di kolom Throughput yang disediakan, masukkan nilai baru untuk throughput yang disediakan.

  7. Opsional: Untuk Hyperdisk Balanced Storage Pools, di kolom IOPS yang disediakan, masukkan nilai baru untuk IOPS yang disediakan.

  8. Klik Simpan untuk memperbarui Kumpulan Penyimpanan.

gcloud

Gunakan perintah gcloud compute storage-pools update untuk mengubah Pool 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 pool.
  • ZONE: Opsional: zona tempat pool berada, misalnya, us-central1-a.
  • POOL_SIZE: Opsional: kapasitas yang disediakan pool, dalam TiB.
  • IOPS: Opsional: IOPS yang disediakan pool. Anda hanya dapat menggunakan flag ini dengan Hyperdisk Balanced Storage Pools.
  • THROUGHPUT: Opsional: throughput yang disediakan pool, dalam MiB/s.
  • DESCRIPTION: Opsional: string deskriptif untuk pool.

REST

Untuk memperbarui kumpulan, 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 pool berada, misalnya, us-central1-a.
  • STORAGE_POOL_NAME: nama pool.
  • DESCRIPTION: Opsional: kolom teks untuk mendeskripsikan pool.
  • SIZE: Opsional: kapasitas yang disediakan kumpulan baru, dalam GiB.
  • IOPS: Opsional: nilai baru untuk IOPS yang disediakan pool. Anda hanya dapat menentukan properti ini jika pool berisi disk berjenis hyperdisk-balanced.
  • THROUGHPUT: Opsional: nilai baru untuk throughput yang disediakan pool, yang ditentukan dalam MiB/dtk.

Mengubah Exapool

Untuk mengubah kapasitas, IOPS, atau throughput yang disediakan dari Exapool, hubungi tim akun Anda.

Menghapus pool

Penghapusan kumpulan tidak dapat diurungkan. Namun, menghapus kumpulan tidak akan menghapus snapshot yang dibuat dari disk yang dibuat di kumpulan tersebut. Anda harus menghapus snapshot secara terpisah.

Menghapus Kumpulan Penyimpanan

Untuk menghapus atau menghapus Kumpulan Penyimpanan, Anda harus menghapus semua disk dalam Kumpulan Penyimpanan terlebih dahulu. Kemudian, gunakan konsol Google Cloud , Google Cloud CLI, atau REST untuk menghapus Kumpulan Penyimpanan.

Konsol

  1. Buka halaman Storage pools di konsol Google Cloud .
    Buka halaman Storage pools
  2. 1. Pilih tab Storage Pools.

  3. Di kolom Name, klik nama Storage Pool yang ingin Anda hapus.

    Halaman Manage storage pool akan terbuka.

  4. Di bagian Storage pool disks, pastikan tidak ada disk yang tercantum untuk Storage Pool.

  5. Klik Hapus pool.

gcloud

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

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

Ganti kode berikut:

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

REST

Untuk menghapus kumpulan, 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 pool berada, misalnya, us-central1-a.
  • STORAGE_POOL_NAME: nama pool unik.

Menghapus Exapool

Untuk menghapus Exapool, hubungi tim akun Anda.

Apa langkah selanjutnya?