Halaman ini menunjukkan cara membuat bucket Cloud Storage. Jika tidak dinyatakan lain dalam permintaan Anda, bucket dibuat dengan kelas penyimpanan default Standard storage dan memiliki durasi retensi penghapusan sementara selama tujuh hari.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan guna membuat bucket Cloud Storage, minta administrator Anda untuk memberi Anda peran IAM Storage Admin (roles/storage.admin
) untuk project tersebut.
Peran bawaan ini berisi izin yang diperlukan untuk membuat bucket. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
storage.buckets.create
storage.buckets.enableObjectRetention
(hanya diperlukan jika mengaktifkan konfigurasi retensi objek untuk bucket)storage.buckets.list
(hanya diperlukan jika membuat bucket menggunakan konsol Trusted Cloud ).resourcemanager.projects.get
(hanya diperlukan jika membuat bucket menggunakan konsol Trusted Cloud )
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 cara memberikan peran untuk project, lihat Mengelola akses ke project.
Buat bucket baru
Jika Anda membuat bucket untuk pertama kalinya, lihat Menemukan penyimpanan objek dengan konsol Trusted Cloud atau Menemukan penyimpanan objek dengan alat Google Cloud CLI.
Untuk membuat bucket dengan setelan tertentu atau konfigurasi lanjutan, selesaikan langkah-langkah berikut:
Konsol
- Di Trusted Cloud konsol, buka halaman Bucket Cloud Storage.
Klik
Create.Di halaman Buat bucket, masukkan informasi bucket Anda. Setelah setiap langkah berikut, klik Lanjutkan untuk melanjutkan ke langkah berikutnya:
Di bagian Mulai, lakukan tindakan berikut:
Masukkan nama yang unik secara global yang memenuhi persyaratan nama bucket.
Untuk menambahkan label bucket, klik panah peluas untuk meluaskan bagian Label, klik add_box Tambahkan label, lalu tentukan
key
danvalue
untuk label Anda.
Di bagian Pilih lokasi untuk menyimpan data Anda, lakukan hal berikut:
Pilih Jenis lokasi.
Gunakan menu drop-down jenis lokasi untuk memilih Location tempat data objek dalam bucket Anda akan disimpan secara permanen.
- Jika memilih jenis lokasi dual-region, Anda juga dapat memilih untuk mengaktifkan replikasi turbo dengan menggunakan kotak centang yang relevan.
Di bagian Pilih cara menyimpan data Anda, lakukan hal berikut:
Pilih kelas penyimpanan default untuk bucket atau Autoclass untuk pengelolaan kelas penyimpanan otomatis untuk data bucket Anda.
Untuk mengaktifkan hierarchical namespace, di bagian Optimize storage for data-intensive workloads, pilih Enable Hierarchical namespace on this bucket.
Di bagian Pilih cara mengontrol akses ke objek, pilih apakah bucket Anda menerapkan pencegahan akses publik atau tidak, lalu pilih model kontrol akses untuk objek bucket Anda.
Di bagian Pilih cara melindungi data objek, lakukan tindakan berikut:
Pilih salah satu opsi di bagian Perlindungan data yang ingin Anda tetapkan untuk bucket Anda.
Untuk mengaktifkan penghapusan sementara, klik panah peluas berlabel kebijakan penghapusan sementara, dan tentukan jumlah hari yang Anda inginkan untuk mempertahankan objek setelah penghapusan.
Untuk memilih cara mengenkripsi data objek Anda, klik panah peluas metode Enkripsi data.
berlabel Enkripsi data, lalu pilih
Klik Buat.
Untuk mempelajari cara mendapatkan informasi error mendetail tentang operasi Cloud Storage yang gagal di Trusted Cloud konsol, lihat Pemecahan masalah.
Command line
-
In the Trusted Cloud console, activate Cloud Shell.
At the bottom of the Trusted 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
Dengan:
BUCKET_NAME
adalah nama yang ingin Anda berikan pada bucket, sesuai dengan persyaratan penamaan. Contohnya,my-bucket
.BUCKET_LOCATION
adalah lokasi bucket Anda. Misalnya,U-FRANCE-EAST1
.
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
.--uniform-bucket-level-access
: Mengaktifkan akses level bucket yang seragam untuk bucket Anda.--soft-delete-duration
: Tentukan durasi retensi penghapusan sementara, yaitu jumlah hari yang Anda inginkan untuk menyimpan objek setelah objek tersebut dihapus. Misalnya,10d
.
Contoh:
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_ID --default-storage-class=STORAGE_CLASS --location=BUCKET_LOCATION --uniform-bucket-level-access --soft-delete-duration=RETENTION_DURATION
Untuk mengetahui daftar lengkap opsi pembuatan bucket menggunakan gcloud CLI, lihat opsi
buckets create
.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
Terraform
Anda dapat menggunakan resource Terraform untuk membuat bucket penyimpanan.
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 harus disertakan:{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, } }
Dengan keterangan:
BUCKET_NAME
adalah nama yang ingin Anda berikan untuk bucket, tunduk pada persyaratan penamaan. Contohnya,my-bucket
.BUCKET_LOCATION
adalah lokasi tempat Anda ingin menyimpan data objek bucket. Contoh,U-FRANCE-EAST1
.STORAGE_CLASS
adalah kelas penyimpanan default bucket Anda. Misalnya,STANDARD
.
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.s3nsapis.fr/storage/v1/b?project=PROJECT_IDENTIFIER"
Dengan:
JSON_FILE_NAME
adalah nama file JSON yang Anda buat di Langkah 2.PROJECT_IDENTIFIER
adalah ID atau nomor project yang akan dikaitkan dengan bucket Anda. Contoh,my-project
.
XML API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization
.Buat file XML yang berisi setelan untuk bucket. Lihat dokumentasi XML: Membuat bucket untuk daftar lengkap setelan. Berikut adalah setelan umum yang dapat disertakan:
<CreateBucketConfiguration> <StorageClass>STORAGE_CLASS</StorageClass> <LocationConstraint>BUCKET_LOCATION</LocationConstraint> </CreateBucketConfiguration>
Dengan:
STORAGE_CLASS
adalah kelas penyimpanan default bucket Anda. Misalnya,STANDARD
.BUCKET_LOCATION
adalah lokasi tempat Anda ingin menyimpan data objek bucket. Contoh,U-FRANCE-EAST1
.
Gunakan
cURL
untuk memanggil XML API:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage.s3nsapis.fr/BUCKET_NAME"
Dengan:
XML_FILE_NAME
adalah nama file XML yang Anda buat di Langkah 2.PROJECT_ID
adalah ID project yang akan dikaitkan dengan bucket Anda. Contoh,my-project
.BUCKET_NAME
adalah nama yang ingin Anda berikan untuk bucket, tunduk pada persyaratan penamaan. Contohnya,my-bucket
.
Jika permintaan berhasil, respons tidak akan ditampilkan.
Langkah berikutnya
- Membuat daftar bucket di project.
- Pelajari metadata yang terkait dengan bucket.
- Memindahkan atau mengganti nama bucket.
- Menghapus bucket.
- Mengupload objek ke bucket Anda.
- Buat dan konfigurasi bucket secara deklaratif dengan Kubernetes Config Connector, yang memungkinkan Anda mendeskripsikan Trusted Cloud by S3NS resource menggunakan alat, API, dan konfigurasi Kubernetes. Untuk mengetahui informasi selengkapnya, lihat dokumentasi API Config Connector.