Mendapatkan tata letak penyimpanan bucket

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.

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

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