Dokumen ini menjelaskan cara mencantumkan, mendeskripsikan, mengubah, dan menghapus pool penyimpanan.
Sebelum memulai
-
Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah
proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Trusted Cloud by S3NS 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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
- Set a default region and zone.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, Anda menggunakan kredensial yang Anda berikan ke gcloud CLI.
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Trusted Cloud .
Peran dan izin yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk mengelola pool 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 pool penyimpanan. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk mengelola pool penyimpanan:
-
Untuk mencantumkan kumpulan penyimpanan untuk project dan zona:
compute.storagePools.list
-
Untuk mencantumkan disk dalam pool penyimpanan:
compute.storagePools.get
-
Untuk melihat properti pool penyimpanan:
compute.storagePools.get
-
Untuk memperbarui kapasitas atau performa yang disediakan dari kumpulan penyimpanan:
-
compute.storagePools.get
-
compute.storagePools.update
-
-
Untuk menghapus pool penyimpanan:
compute.storagePools.delete
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Batasan
Perhatikan batasan berikut saat mengelola Gabungan Penyimpanan Hyperdisk:
- Anda dapat mengubah kapasitas atau performa yang disediakan untuk pool penyimpanan maksimal dua kali dalam periode 24 jam.
- Anda tidak dapat mengubah model penyediaan untuk pool; Anda tidak dapat mengubah pool penyimpanan berkapasitas Standar menjadi pool penyimpanan berkapasitas Lanjutan atau pool penyimpanan berperforma Lanjutan menjadi pool penyimpanan berperforma Standar.
- Memindahkan disk ke dalam atau ke luar pool 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 dari, atau mengonfigurasi Replikasi Asinkron untuk disk di kumpulan penyimpanan.
- Anda dapat menghapus maksimal 5 pool penyimpanan per jam.
- Perintah pengelolaan pool penyimpanan akan berhasil atau gagal segera, tetapi tindakan ini dapat memerlukan waktu hingga 5 menit untuk diselesaikan, dan hingga 30 menit agar perubahan muncul.
Untuk daftar lengkap batasan Hyperdisk Storage Pool, lihat Batasan kumpulan penyimpanan.
Rentang nilai saat mengubah pool 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 pool penyimpanan.
Mencantumkan kumpulan penyimpanan untuk project
Untuk melihat pool penyimpanan yang dibuat dalam project, gunakan Trusted Cloud konsol, Google Cloud CLI, atau REST.
Konsol
Buka halaman Storage pools di konsol Trusted Cloud .
Buka halaman Storage poolsHalaman ini menampilkan kumpulan penyimpanan yang dibuat dalam project yang dipilih.
Opsional: Gunakan kolom Filter untuk menampilkan hanya pool penyimpanan yang cocok dengan parameter filter, seperti Lokasi, Jenis, Nama, dan Kapasitas pool yang tersisa.
gcloud
Untuk mencantumkan semua pool penyimpanan 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 metodestoragePools.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 penyimpanan berada, misalnya,
us-central1-a
.
Mencantumkan disk dalam pool penyimpanan
Untuk mendapatkan daftar disk yang dibuat di pool penyimpanan, gunakan Trusted Cloud konsol, Google Cloud CLI, atau REST.
Konsol
Buka halaman Storage pools di konsol Trusted Cloud .
Buka halaman Storage poolsHalaman ini menampilkan kumpulan penyimpanan yang dibuat dalam project yang dipilih.
Di kolom Name, klik nama pool penyimpanan yang ingin Anda lihat.
Halaman Manage storage pool akan terbuka.
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 pool penyimpanan.
- ZONE: Opsional. Zona tempat pool penyimpanan berada, misalnya,
us-central1-a
.
REST
Untuk mencantumkan disk yang menggunakan kumpulan penyimpanan, buat permintaan
GET
menggunakan metodestoragePools.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 penyimpanan berada, misalnya,
us-central1-a
. - STORAGE_POOL_NAME: nama pool penyimpanan.
Mendeskripsikan kumpulan penyimpanan
Untuk melihat detail pool penyimpanan, Anda dapat menggunakan Trusted Cloud konsol, Google Cloud CLI, atau REST.
Konsol
- Buka halaman Storage pools di konsol Trusted Cloud .
Buka halaman Storage pools Untuk setiap kumpulan penyimpanan yang tercantum di halaman, Anda dapat melihat informasi berikut:
- Status
- Nama
- Lokasi
- Jenis kolam
- Kapasitas kumpulan
- Kapasitas gabungan yang tersisa
- IOPS Kumpulan
- IOPS pool yang tersisa
- Jumlah disk yang dibuat di pool
Di kolom Name, klik nama pool penyimpanan yang ingin Anda lihat.
Halaman Manage storage pool akan terbuka.
Di kartu di bagian atas halaman, Anda dapat melihat kapasitas yang disediakan dan digunakan, serta throughput dan IOPS yang disediakan dan digunakan untuk kumpulan penyimpanan.
Di bagian Setelan kumpulan penyimpanan, Anda dapat melihat properti tambahan kumpulan penyimpanan, seperti waktu pembuatan, jenis penyediaan kapasitas, jenis penyediaan performa, jumlah total disk dalam kumpulan penyimpanan, dan persentase pemanfaatan untuk kapasitas, throughput, dan IOPS.
Di bagian Storage pool disks, Anda dapat melihat informasi tentang disk yang dibuat di storage pool.
Opsional: Untuk informasi tambahan tentang penggunaan kumpulan penyimpanan, Anda dapat mengklik tab Monitoring untuk melihat grafik berbagai metrik kumpulan penyimpanan. Untuk mengetahui informasi selengkapnya, lihat Memantau Gabungan Penyimpanan Hyperdisk.
gcloud
Gunakan perintah
gcloud compute storage-pools describe
untuk melihat detail pool penyimpanan.gcloud compute storage-pools describe STORAGE_POOL_NAME \ [--zone=ZONE]
Ganti kode berikut:
- STORAGE_POOL_NAME: nama pool penyimpanan yang unik.
- ZONE: Opsional. Zona tempat pool penyimpanan berada, misalnya,
us-central1-a
.
REST
Untuk mengambil detail tentang kumpulan penyimpanan, buat permintaan
GET
menggunakan metodestoragePools.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 pool penyimpanan berada,
misalnya,
us-central1-a
- STORAGE_POOL_NAME: nama pool penyimpanan
Memperbarui kapasitas, IOPS, atau throughput yang disediakan untuk pool penyimpanan
Anda dapat menambah atau mengurangi kapasitas, IOPS, atau throughput yang disediakan dari kumpulan penyimpanan. Untuk meningkatkan kapasitas, IOPS, atau throughput kumpulan penyimpanan, Anda harus memiliki kuota yang tersedia untuk project dan region.
Konsol
- Buka halaman Storage pools di konsol Trusted Cloud .
Buka halaman Storage pools Di kolom Name, klik nama pool penyimpanan yang ingin Anda ubah.
Halaman Manage storage pool akan terbuka.
Klik
Edit.Halaman Edit storage pool akan terbuka.
Opsional: Di kolom Kapasitas pool penyimpanan, masukkan nilai baru untuk kapasitas yang disediakan 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 Throughput yang disediakan, masukkan nilai baru untuk throughput yang disediakan.
Opsional: Untuk kumpulan penyimpanan jenis Hyperdisk Seimbang, di kolom IOPS yang disediakan, masukkan nilai baru untuk IOPS yang disediakan.
Klik Simpan untuk memperbarui pool 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 penyimpanan.
- ZONE: Opsional: zona tempat pool penyimpanan berada, misalnya,
us-central1-a
. - POOL_SIZE: Opsional: kapasitas yang dialokasikan untuk penyimpanan bersama, dalam TiB.
- IOPS: Opsional: IOPS yang disediakan untuk kumpulan penyimpanan. Anda hanya dapat menggunakan flag ini dengan Hyperdisk Balanced Storage Pools.
- THROUGHPUT: Opsional: throughput yang disediakan kumpulan penyimpanan, dalam MiB/s.
- DESCRIPTION: Opsional: string deskriptif untuk kumpulan penyimpanan.
REST
Untuk memperbarui kumpulan penyimpanan, buat permintaan
PATCH
menggunakan metodestoragePools.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 penyimpanan berada, misalnya,
us-central1-a
. - STORAGE_POOL_NAME: nama pool penyimpanan.
- DESCRIPTION: Opsional: kolom teks untuk mendeskripsikan kumpulan penyimpanan.
- SIZE: Opsional: kapasitas yang dialokasikan untuk kumpulan penyimpanan baru, 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 MiB/s.
Menghapus penyimpanan bersama
Untuk menghapus atau menghapus kumpulan penyimpanan, Anda harus menghapus semua disk dalam kumpulan penyimpanan terlebih dahulu. Kemudian, Anda dapat menggunakan Trusted Cloud konsol, Google Cloud CLI, atau REST untuk menghapus pool 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
- Buka halaman Storage Pool di konsol Trusted Cloud .
Buka halaman Storage Pool Di kolom Name, klik nama pool penyimpanan yang ingin Anda hapus.
Halaman Manage storage pool akan terbuka.
Di bagian Storage pool disks, pastikan tidak ada disk yang tercantum untuk storage pool.
Klik
Hapus pool.
gcloud
Gunakan perintah
gcloud compute storage-pools delete
untuk menghapus pool penyimpanan.gcloud compute storage-pools delete STORAGE_POOL_NAME \ --zone=ZONE \
Ganti kode berikut:
- STORAGE_POOL_NAME: nama pool penyimpanan yang unik.
- ZONE: Opsional: zona tempat pool penyimpanan berada, misalnya,
us-central1-a
.
REST
Untuk menghapus kumpulan penyimpanan, buat permintaan
DELETE
untuk metodestoragePools.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 penyimpanan berada, misalnya,
us-central1-a
. - STORAGE_POOL_NAME: nama pool penyimpanan yang unik.
Apa langkah selanjutnya?
- Pelajari lebih lanjut kumpulan penyimpanan.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-08 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-08 UTC."],[[["This document details the management of storage pools, covering how to list, describe, update, and delete them using the Google Cloud console, gcloud CLI, or REST API."],["Managing storage pools requires specific IAM roles and permissions, including `compute.storagePools.list`, `compute.storagePools.get`, `compute.storagePools.update`, and `compute.storagePools.delete`."],["There are limitations to storage pool management, such as only allowing two changes to provisioned capacity or performance in a 24-hour period, and restrictions on moving disks in or out of a storage pool, and there's a limit of 5 storage pool deletions per hour."],["Updating storage pool capacity, IOPS, or throughput can be done, with specific value range limitations, and it may take up to 30 minutes for the changes to be reflected."],["Deleting a storage pool requires that all disks within the pool be removed first and is irreversible, though snapshots of the disks are not deleted automatically."]]],[]] -