Mendapatkan tata letak penyimpanan bucket

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Halaman ini menjelaskan cara menentukan tata letak penyimpanan bucket Anda. Tata letak penyimpanan mengacu pada cara objek diatur dalam bucket, baik dalam namespace datar atau namespace hierarkis. Tata letak penting untuk aplikasi yang berinteraksi dengan bucket, karena metode akses dan manipulasi objek bervariasi bergantung pada tata letaknya. 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 Anda untuk memberi Anda peran Storage Object User (roles/storage.objectUser) di bucket tersebut.

Peran ini 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 mengetahui peran mana yang terkait dengan izin apa, lihat Peran IAM untuk Cloud Storage.

Untuk mengetahui petunjuk tentang cara memberikan peran pada bucket, lihat Menggunakan IAM dengan bucket.

Mendapatkan tata letak penyimpanan bucket

Command line

Gunakan perintah gcloud alpha storage buckets describe dengan flag --format:

gcloud alpha storage buckets describe gs://BUCKET_NAME --raw --format="default(hierarchicalNamespace)"

Dengan:

• 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

JSON API

1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

2. Gunakan cURL untuk memanggil JSON API dengan permintaan getStorageLayout:

   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

• Memahami folder.
• Membuat dan mengelola folder.
• Mengganti nama folder.

Coba sendiri

Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa Cloud Storage dalam skenario dunia nyata. Pelanggan baru juga akan mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

Coba Cloud Storage gratis