Halaman ini menjelaskan cara membuat bucket dengan namespace hierarkis diaktifkan.
Peran yang diperlukan
Untuk mendapatkan izin yang
diperlukan untuk membuat bucket dengan namespace hierarkis diaktifkan,
minta administrator Anda untuk memberi Anda
peran IAM Storage Admin (roles/storage.admin
)
di project.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin
storage.buckets.create
, yang
diperlukan untuk
membuat bucket dengan namespace hierarkis yang diaktifkan.
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Membuat bucket dengan namespace hierarkis diaktifkan
Konsol
- Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
- Klik Create.
- Di halaman Buat bucket, masukkan informasi bucket Anda, lalu klik Lanjutkan:
- Di bagian Mulai, lakukan tindakan berikut:
- Masukkan nama bucket yang unik secara global dan memenuhi persyaratan nama bucket.
- Untuk mengaktifkan hierarchical namespace, klik
panah peluas untuk meluaskan bagian Optimalkan untuk beban kerja berorientasi file dan intensif data, lalu pilih Aktifkan Hierarchical namespace di bucket ini.
Catatan: Anda tidak dapat mengaktifkan namespace hierarkis di bucket yang sudah ada.
- Opsional: Untuk menambahkan label bucket, klik
panah peluas untuk meluaskan bagian Label, lalu klik
add_box Tambahkan
label, dan tentukan
key
danvalue
untuk label Anda. - Di bagian Pilih lokasi untuk menyimpan data Anda, lakukan hal berikut:
- Pilih Region sebagai Jenis lokasi.
- Di daftar Location, pilih region tempat data bucket akan disimpan secara permanen.
- Di bagian Pilih kelas penyimpanan untuk data Anda, pilih
Tetapkan kelas default untuk bucket.
Catatan: Panel Estimasi biaya bulanan di panel kanan memperkirakan biaya bulanan bucket berdasarkan kelas dan lokasi penyimpanan pilihan Anda, serta perkiraan operasi dan ukuran data.
- Di bagian Pilih cara mengontrol akses ke objek, pilih apakah bucket Anda menerapkan pencegahan akses publik atau tidak, lalu untuk Kontrol akses, pilih Seragam.
Catatan: Jika pencegahan akses publik sudah diterapkan oleh kebijakan organisasi project Anda, tombol Prevent public access akan dikunci.
- Di bagian Pilih cara melindungi data objek, lakukan tindakan berikut:
- Opsional: Pilih metode Perlindungan data seperti mengonfigurasi kebijakan penghapusan sementara kustom, pembuatan versi objek, atau kebijakan retensi.
- Untuk memilih metode Enkripsi data, klik panah peluas berlabel Enkripsi data.
- Klik Buat.
Untuk mempelajari cara mendapatkan informasi error mendetail tentang operasi Cloud Storage yang gagal di Google Cloud konsol, lihat Pemecahan masalah.
Command line
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
-
Di lingkungan pengembangan Anda, jalankan perintah
gcloud storage buckets create
:gcloud storage buckets create gs://BUCKET_NAME --location=BUCKET_LOCATION --uniform-bucket-level-access --enable-hierarchical-namespace
Dengan:
BUCKET_NAME
adalah nama yang ingin Anda berikan pada bucket, sesuai dengan persyaratan penamaan. Contoh,my-bucket
.BUCKET_LOCATION
adalah lokasi bucket Anda. Misalnya,us-east1
.--uniform-bucket-level-access
: Mengaktifkan akses level bucket yang seragam untuk bucket.
--enable-hierarchical-namespace
: Aktifkan namespace hierarkis untuk bucket. Anda tidak dapat mengaktifkan namespace hierarkis di bucket yang sudah ada.
Jika permintaan berhasil, perintah akan menampilkan pesan berikut ini:
Creating gs://BUCKET_NAME/...
Tetapkan flag berikut untuk memiliki kontrol yang lebih besar atas pembuatan bucket Anda:
--project
: Tentukan project ID atau nomor project yang akan dikaitkan dengan bucket Anda. Contoh,my-project
.--default-storage-class
: Menentukan kelas penyimpanan default bucket Anda. Misalnya,STANDARD
.
Untuk mengetahui daftar lengkap opsi pembuatan bucket menggunakan Google Cloud CLI, lihat opsi
buckets create
.Contoh:
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_ID --default-storage-class=STORAGE_CLASS --location=BUCKET_LOCATION --uniform-bucket-level-access
Library Klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
C#
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C# API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Go
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Go API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Node.js
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
PHP
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Python
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Ruby
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Ruby API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization
.- Buat file JSON yang berisi setelan untuk bucket, yang harus menyertakan
name
untuk bucket. Lihat dokumentasi Buckets: Insert untuk daftar lengkap setelan. Berikut adalah setelan umum yang dapat disertakan: BUCKET_NAME
adalah nama yang ingin Anda berikan pada bucket, sesuai dengan persyaratan penamaan. Misalnya,my-bucket
.BUCKET_LOCATION
adalah lokasi tempat Anda ingin menyimpan data objek bucket. Misalnya,US-EAST1
.STORAGE_CLASS
adalah kelas penyimpanan default untuk bucket Anda. Misalnya,STANDARD
.hierarchicalNamespace.enabled
ditetapkan keTRUE
untuk mengaktifkan namespace hierarkis untuk bucket Anda. Anda tidak dapat mengaktifkan namespace hierarkis di bucket yang sudah ada.uniformBucketLevelAccess.enabled
disetel keTRUE
untuk mengaktifkan akses level bucket yang seragam untuk bucket Anda.
- Gunakan
cURL
untuk memanggil JSON API:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b?project=PROJECT_IDENTIFIER"
Dengan:
JSON_FILE_NAME
adalah nama file JSON yang berisi setelan bucket.PROJECT_IDENTIFIER
adalah ID atau nomor project yang akan dikaitkan dengan bucket Anda. Contoh,my-project
.
{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "hierarchicalNamespace": { "enabled": "BOOLEAN" }, "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, }, }
Dengan keterangan:
Langkah berikutnya
- Memahami folder.
- Membuat dan mengelola folder.
- Mendapatkan metadata bucket.
- Mendapatkan tata letak penyimpanan bucket.
- Mencantumkan dan menghapus bucket.
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