Halaman ini menunjukkan cara membuat bucket Cloud Storage. Jika tidak
dinyatakan lain dalam permintaan Anda, bucket akan dibuat di
multi-region US
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 Google Cloud ).resourcemanager.projects.get
(hanya diperlukan jika membuat bucket menggunakan konsol Google 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 Google 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 Google 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.
Untuk menyiapkan replikasi lintas bucket, pilih Tambahkan replikasi lintas bucket melalui Storage Transfer Service dan ikuti langkah-langkahnya:
Menyiapkan replikasi lintas bucket
- Di menu Bucket, pilih bucket.
Di bagian Setelan replikasi, klik Konfigurasi untuk mengonfigurasi setelan bagi tugas replikasi.
Panel Konfigurasi replikasi lintas bucket akan muncul.
- Untuk memfilter objek yang akan direplikasi menurut awalan nama objek, masukkan awalan yang ingin Anda sertakan atau kecualikan objeknya, lalu klik Tambahkan awalan.
- Untuk menetapkan kelas penyimpanan bagi objek yang direplikasi, pilih kelas penyimpanan dari menu Kelas penyimpanan. Jika Anda melewati langkah ini, objek yang direplikasi akan menggunakan kelas penyimpanan bucket tujuan secara default.
- Klik Selesai.
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 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
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,US
.
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.
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.
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,US
.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.googleapis.com/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,US
.
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.googleapis.com/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 Google Cloud resource menggunakan alat, API, dan konfigurasi Kubernetes. Untuk mengetahui informasi selengkapnya, lihat dokumentasi API Config Connector.
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