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. Penyimpanan mengacu pada bagaimana objek diatur dalam bucket, baik dalam tabel atau namespace hierarkis. {i>Layout<i} adalah penting untuk aplikasi yang berinteraksi dengan bucket, seperti manipulasi dan akses objek bervariasi tergantung tata letaknya. Tata letak penyimpanan juga menyertakan informasi mengenai lokasi bucket.

Dengan menggunakan getStorageLayout API, aplikasi Anda dapat menyesuaikannya berdasarkan apakah bucket menggunakan namespace hierarkis atau tidak, yang memastikan kompatibilitas yang optimal dan memanfaatkan fitur yang tepat berdasarkan konfigurasi bucket.

Peran wajib diisi

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 tersebut.

Peran tersebut berisi izin storage.objects.list, yang yang diperlukan untuk mendapatkan tata letak penyimpanan bucket.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus lainnya atau peran bawaan. Untuk melihat peran yang dikaitkan dengan izin tertentu, 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 keterangan:

• BUCKET_NAME adalah nama bucket yang relevan. Contoh, my-bucket.

Jika namespace yang berhasil dan hierarkis diaktifkan, respons akan terlihat mirip dengan contoh berikut:

  hierarchicalNamespace:
    enabled: true

JSON API

1. Membuat gcloud CLI menginstal dan melakukan inisialisasi, untuk membuat token akses untuk header Authorization.

   Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di 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 selanjutnya

• 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 mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

Coba Cloud Storage gratis