Halaman ini menjelaskan cara menentukan tata letak penyimpanan bucket Anda. Tata letak penyimpanan mengacu pada cara objek diatur dalam bucket, baik dalam namespace datar maupun namespace hierarkis. Tata letak penting untuk aplikasi yang berinteraksi dengan bucket, karena metode akses dan manipulasi objek bervariasi bergantung pada tata letak. Tata letak penyimpanan juga mencakup informasi tentang lokasi bucket.
Dengan menggunakan getStorageLayout
API, aplikasi Anda dapat menyesuaikan
perilakunya berdasarkan apakah bucket menggunakan namespace hierarkis atau tidak, sehingga memastikan
kompatibilitas yang optimal dan memanfaatkan fitur yang sesuai berdasarkan
konfigurasi bucket.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan guna mendapatkan tata letak penyimpanan bucket Cloud Storage , minta administrator untuk memberi Anda peran Storage Object User (roles/storage.objectUser
) di bucket.
Peran tersebut berisi izin storage.objects.list
, yang diperlukan untuk mendapatkan tata letak penyimpanan bucket.
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya. Untuk melihat peran mana yang terkait dengan izin apa, lihat Peran IAM untuk Cloud Storage.
Untuk mengetahui petunjuk cara memberikan peran pada bucket, lihat Menggunakan IAM dengan bucket.
Mendapatkan tata letak penyimpanan bucket
Gunakan perintah gcloud alpha storage buckets describe
dengan flag --format
:
gcloud alpha storage buckets describe gs://BUCKET_NAME --raw --format="default(hierarchicalNamespace)"
Dengan keterangan:
BUCKET_NAME
adalah nama bucket yang relevan. Contoh,my-bucket
.
Jika berhasil dan namespace hierarkis diaktifkan, responsnya akan terlihat mirip dengan contoh berikut:
hierarchicalNamespace: enabled: true
Menginstal dan melakukan inisialisasi gcloud CLI , yang memungkinkan Anda membuat token akses untuk header
Authorization
.Gunakan
cURL
untuk memanggil JSON API dengan permintaangetStorageLayout
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/
BUCKET_NAME /storageLayout"Dengan
BUCKET_NAME
adalah nama bucket yang relevan. Contoh,my-bucket
.Jika berhasil, responsnya akan terlihat seperti contoh berikut:
{ "kind": "storage#storageLayout", "bucket": "my-bucket", "location": "us-central1", "locationType": "region", "hierarchicalNamespace":{enabled: true}, }
Langkah berikutnya
Coba sendiri
Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa Cloud Storage dalam skenario dunia nyata. Pelanggan baru mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
Coba Cloud Storage gratis