Dokumen ini menjelaskan cara mencantumkan, menjelaskan, mengubah, dan menghapus kumpulan penyimpanan.
Sebelum memulai
-
Siapkan autentikasi, jika Anda belum melakukannya.
Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud.
Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.
Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:
Konsol
Saat menggunakan Konsol Google Cloud untuk mengakses API dan layanan Google Cloud, Anda tidak perlu menyiapkan autentikasi.
gcloud
-
Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
gcloud init
- Menetapkan 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, lalu initialize dengan menjalankan perintah berikut:
gcloud init
-
Peran dan izin yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk mengelola penyimpanan gabungan, minta administrator Anda untuk memberi Anda peran IAM berikut pada project:
-
Admin Instance Compute (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.
Peran bawaan ini berisi izin yang diperlukan untuk mengelola penyimpanan bersama. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk mengelola penyimpanan bersama:
-
Untuk mencantumkan kumpulan penyimpanan untuk project dan zona:
compute.storagePools.list
-
Untuk mencantumkan disk dalam penyimpanan bersama:
compute.storagePools.get
-
Untuk melihat properti kumpulan penyimpanan:
compute.storagePools.get
-
Untuk memperbarui kapasitas atau performa yang disediakan untuk penyimpanan gabungan:
-
compute.storagePools.get
-
compute.storagePools.update
-
-
Untuk menghapus penyimpanan gabungan:
compute.storagePools.delete
Anda mung juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaanlainnya.
Batasan
Perhatikan batasan berikut saat mengelola Kumpulan Penyimpanan Hyperdisk:
- Anda dapat mengubah kapasitas yang disediakan untuk penyimpanan bersama maksimal dua kali dalam periode 24 jam.
- Dilarang memindahkan disk ke dalam atau ke luar kumpulan penyimpanan. Untuk memasukkan atau mengeluarkan disk dari penyimpanan gabungan, 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 di penyimpanan gabungan.
- Anda dapat menghapus maksimal 5 kumpulan penyimpanan per jam.
- Perintah pengelolaan kumpulan penyimpanan berhasil atau gagal dengan segera, tetapi diperlukan waktu hingga 5 menit untuk menyelesaikan tindakan, dan hingga 30 menit agar perubahan ditampilkan.
Untuk mengetahui daftar lengkap batasan Kumpulan Penyimpanan Hyperdisk, lihat Batasan gabungan penyimpanan.
Rentang nilai saat mengubah kumpulan penyimpanan
Kapasitas minimum yang disediakan untuk kumpulan penyimpanan adalah 10 TiB, dan kapasitas maksimum yang disediakan adalah 1 PiB. Anda dapat mengubah kapasitas yang disediakan untuk penyimpanan bersama dengan kelipatan 1 TiB.
Untuk batas penyediaan performa, lihat hal berikut:
- Batas untuk Tampungan Penyimpanan Throughput Hyperdisk
- Batas untuk Kumpulan Penyimpanan Seimbang Hyperdisk
Membuat daftar kumpulan penyimpanan untuk sebuah project
Untuk melihat kumpulan penyimpanan yang dibuat dalam sebuah project, gunakan konsol Google Cloud, Google Cloud CLI, atau REST.
Konsol
Buka halaman Storage pool di Konsol Google Cloud.
Buka halaman Storage poolHalaman ini menampilkan kumpulan penyimpanan yang dibuat dalam project yang dipilih.
Opsional: Gunakan panel Filter untuk hanya menampilkan kumpulan penyimpanan yang cocok dengan parameter filter, seperti Lokasi, Jenis, Nama, dan Kapasitas gabungan yang tersisa.
gcloud
Untuk menampilkan daftar semua kumpulan penyimpanan yang dibuat dalam project saat ini, gunakan
perintah gcloud compute storage-pools list
.
gcloud compute storage-pools list
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 kumpulan penyimpanan
- ZONE: zona tempat kumpulan penyimpanan berada,
misalnya,
us-central1-a
.
Membuat daftar disk di kumpulan penyimpanan
Untuk mendapatkan daftar disk yang dibuat di penyimpanan gabungan, gunakan Konsol Google Cloud, Google Cloud CLI, atau REST.
Konsol
Buka halaman Storage pool di Konsol Google Cloud.
Buka halaman Storage poolHalaman ini menampilkan kumpulan penyimpanan yang dibuat dalam project yang dipilih.
Di kolom Name, klik nama kumpulan penyimpanan yang ingin Anda lihat.
Halaman Kelola penyimpanan bersama akan terbuka.
Di bagian Penyimpanan gabungan disk, Anda dapat melihat disk yang dibuat di penyimpanan gabungan.
gcloud
Untuk menampilkan daftar disk yang dibuat di penyimpanan bersama, 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 kumpulan penyimpanan.
- 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 kumpulan penyimpanan
- ZONE: zona tempat kumpulan penyimpanan berada,
misalnya,
us-central1-a
. - STORAGE_POOL_NAME: nama kumpulan penyimpanan.
Menjelaskan kumpulan penyimpanan
Untuk melihat detail penyimpanan bersama, Anda dapat menggunakan Konsol Google Cloud, Google Cloud CLI, atau REST.
Konsol
- Buka halaman Storage pool di Konsol Google Cloud.
Buka halaman Storage pool Untuk setiap penyimpanan yang tercantum di halaman, Anda dapat melihat informasi berikut:
- Status
- Nama
- Location
- Jenis kolam
- Kapasitas kolam
- Kapasitas kolam tersisa
- IOPS Kumpulan
- Kumpulan IOPS tersisa
- Jumlah disk yang dibuat dalam kumpulan
Di kolom Name, klik nama penyimpanan yang ingin Anda lihat.
Halaman Kelola penyimpanan bersama akan terbuka.
Di bagian Setelan penyimpanan gabungan, Anda dapat melihat properti tambahan penyimpanan gabungan, seperti waktu pembuatan dan jenis penyediaan kapasitas.
Di bagian Penyimpanan gabungan disk, Anda dapat melihat informasi tentang disk yang dibuat di penyimpanan gabungan.
gcloud
Gunakan perintah gcloud compute storage-pools describe
untuk melihat detail penyimpanan gabungan.
gcloud compute storage-pools describe STORAGE_POOL_NAME \ [--zone=ZONE]
Ganti kode berikut:
- STORAGE_POOL_NAME: nama unik penyimpanan gabungan.
- 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 kumpulan penyimpanan
- ZONE: zona tempat kumpulan penyimpanan berada,
misalnya,
us-central1-a
- STORAGE_POOL_NAME: nama kumpulan penyimpanan
Memperbarui kapasitas yang disediakan, IOPS, atau throughput penyimpanan gabungan
Anda dapat meningkatkan atau mengurangi kapasitas yang disediakan, IOPS, atau throughput gabungan penyimpanan. Untuk meningkatkan kapasitas, IOPS, atau throughput penyimpanan gabungan, Anda harus memiliki kuota yang tersedia untuk project dan region.
Konsol
- Buka halaman Storage pool di Konsol Google Cloud.
Buka halaman Storage pool Di kolom Name, klik nama penyimpanan gabungan yang ingin Anda ubah.
Halaman Kelola penyimpanan bersama akan terbuka.
Klik
Edit.Halaman Edit penyimpanan gabungan akan terbuka.
Opsional: Di kolom Kapasitas penyimpanan gabungan, masukkan nilai baru untuk kapasitas yang disediakan kumpulan. Nilai baru minimal harus 1 TiB dan maksimum 100 TiB lebih banyak atau kurang dari nilai saat ini. Ukuran minimum tidak boleh kurang dari 10 TiB dan ukuran maksimum tidak boleh lebih dari 1.024 TiB.
Opsional: Di kolom Throughput yang disediakan, masukkan nilai baru untuk throughput yang disediakan.
Opsional: Untuk kumpulan penyimpanan jenis Hyperdisk Balanced, di kolom Provideed IOPS, masukkan nilai baru untuk IOPS yang disediakan.
Klik Simpan untuk memperbarui penyimpanan gabungan.
gcloud
Gunakan perintah gcloud compute storage-pools update
untuk mengubah penyimpanan bersama.
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 kumpulan penyimpanan.
- ZONE: Opsional: zona tempat kumpulan penyimpanan
berada, misalnya,
us-central1-a
. - POOL_SIZE: Opsional: kapasitas penyimpanan yang disediakan, dalam TiB.
- IOPS: Opsional: IOPS yang disediakan kumpulan penyimpanan. Anda dapat menggunakan tanda ini hanya dengan Kumpulan Penyimpanan Seimbang Hyperdisk.
- THROUGHPUT: Opsional: gabungan penyimpanan yang disediakan throughput, 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 kumpulan penyimpanan berada,
misalnya,
us-central1-a
. - STORAGE_POOL_NAME: nama kumpulan penyimpanan.
- DESCRIPTION: Opsional: kolom teks untuk mendeskripsikan kumpulan penyimpanan.
- SIZE: Opsional: kapasitas penyimpanan gabungan baru yang disediakan, dalam GiB.
- IOPS: Opsional: nilai baru untuk IOPS yang disediakan kumpulan penyimpanan. Anda hanya dapat menentukan properti ini jika kumpulan penyimpanan 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 meniadakan penyimpanan bersama, Anda harus menghapus semua disk di dalam kumpulan penyimpanan terlebih dahulu. Kemudian, Anda dapat menggunakan konsol Google Cloud, Google Cloud CLI, atau REST untuk menghapus penyimpanan bersama.
Penghapusan kumpulan penyimpanan tidak dapat dibatalkan. Namun, menghapus kumpulan penyimpanan tidak akan menghapus snapshot apa pun yang dibuat dari disk yang dibuat di penyimpanan gabungan. Anda harus menghapus snapshot secara terpisah.
Konsol
- Buka halaman Storage Pool di Konsol Google Cloud.
Buka halaman Storage Pool Di kolom Name, klik nama penyimpanan gabungan yang ingin Anda hapus.
Halaman Kelola penyimpanan bersama akan terbuka.
Di bagian Penyimpanan gabungan disk, pastikan tidak ada disk yang tercantum untuk penyimpanan bersama.
Klik
Hapus kumpulan.
gcloud
Gunakan perintah gcloud compute storage-pools delete
untuk menghapus penyimpanan bersama.
gcloud compute storage-pools delete STORAGE_POOL_NAME \ --zone=ZONE \
Ganti kode berikut:
- STORAGE_POOL_NAME: nama unik penyimpanan gabungan.
- 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 kumpulan penyimpanan berada,
misalnya,
us-central1-a
. - STORAGE_POOL_NAME: nama unik penyimpanan gabungan.
Apa langkah selanjutnya?
- Pelajari lebih lanjut kumpulan penyimpanan.