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:
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
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.
Buka halaman Storage pool di konsol Google Cloud.
Buka halaman Storage poolsHalaman 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 Ketersediaan kapasitas kumpulan.
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"
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.
Buka halaman Storage pool di konsol Google Cloud.
Buka halaman Storage poolsHalaman ini menampilkan kumpulan penyimpanan yang dibuat dalam project yang dipilih.
Di kolom Name, klik nama storage pool yang ingin Anda lihat.
Halaman Kelola kumpulan penyimpanan akan terbuka.
Di bagian Storage pool disks, Anda dapat melihat disk yang dibuat di storage pool.
Untuk mencantumkan disk yang dibuat di kumpulan penyimpanan, gunakan
perintah gcloud compute storage-pools list-disks
.
gcloud compute storage-pools list-disksSTORAGE_POOL_NAME \ [--zone=ZONE ]
Ganti kode berikut:
- STORAGE_POOL_NAME: nama penyimpanan pool.
- ZONE: Opsional. Zona tempat kumpulan penyimpanan berada, misalnya,
us-central1-a
.
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.
- Buka halaman Storage pool di konsol Google Cloud.
Buka halaman Storage pools 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
Di kolom Name, klik nama storage pool yang ingin Anda lihat.
Halaman Kelola kumpulan penyimpanan akan terbuka.
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.
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.
Di bagian Disk penyimpanan, Anda dapat melihat informasi tentang disk yang dibuat di penyimpanan.
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.
Gunakan perintah gcloud compute storage-pools describe
untuk melihat detail penyimpanan.
gcloud compute storage-pools describeSTORAGE_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
.
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.
- Buka halaman Storage pool di konsol Google Cloud.
Buka halaman Storage pools Di kolom Name, klik nama storage pool yang ingin Anda ubah.
Halaman Kelola kumpulan penyimpanan akan terbuka.
Klik
Edit.Halaman Edit storage pool akan terbuka.
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.
Opsional: Di kolom Provisioned throughput, masukkan nilai baru untuk throughput yang disediakan.
Opsional: Untuk storage pool jenis Hyperdisk Balanced, di kolom Provisioned IOPS, masukkan nilai baru untuk IOPS yang disediakan.
Klik Simpan untuk memperbarui kumpulan penyimpanan.
Gunakan perintah gcloud compute storage-pools update
untuk mengubah penyimpanan.
gcloud compute storage-pools updateSTORAGE_POOL_NAME \ --zone=ZONE \ --provisioned-capacity=POOL_SIZE TiB \ --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.
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.
- Buka halaman Storage Pool di konsol Google Cloud.
Buka halaman Storage Pool Di kolom Name, klik nama storage pool yang ingin Anda hapus.
Halaman Kelola kumpulan penyimpanan akan terbuka.
Di bagian Storage pool disks, pastikan tidak ada disk yang tercantum untuk storage pool.
Klik
Hapus pool.
Gunakan perintah gcloud compute storage-pools delete
untuk menghapus storage pool.
gcloud compute storage-pools deleteSTORAGE_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
.
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?
- Pelajari storage pool lebih lanjut.