Halaman ini menjelaskan cara menggunakan penyimpanan dual-region.
Peran yang diperlukan
Guna mendapatkan izin yang diperlukan untuk membuat bucket dengan region ganda, minta administrator Anda untuk memberi Anda peran IAM Storage Admin (roles/storage.admin
) untuk project tersebut.
Peran standar ini berisi izin yang diperlukan untuk membuat bucket dengan region ganda. Untuk melihat izin persis yang 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 melihat peran yang terkait dengan izin tertentu, lihat Peran IAM untuk Cloud Storage.
Untuk mengetahui petunjuk tentang cara memberikan peran untuk project, baca bagian Mengelola akses ke project.
Membuat bucket region ganda
Selesaikan langkah-langkah berikut untuk membuat bucket dual-region:
Konsol
- Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.
Klik Create.
Di halaman Buat bucket, masukkan informasi bucket Anda. Untuk melanjutkan ke langkah berikutnya, klik Lanjutkan.
Untuk Beri nama bucket Anda, masukkan nama yang memenuhi persyaratan penamaan bucket.
Untuk Pilih tempat untuk menyimpan data, di samping Jenis lokasi, pilih Dual-region. Opsional: Anda dapat menggabungkan fitur ini dengan replikasi turbo, dengan mencentang kotak Tambahkan replikasi turbo.
Untuk Lokasi, pilih Benua dan Region terkait yang ingin Anda gunakan.
Untuk Pilih kelas penyimpanan default untuk data Anda, pilih kelas penyimpanan untuk bucket. Kelas penyimpanan default ditetapkan secara default pada semua objek yang diupload ke bucket.
Untuk Pilih cara mengontrol akses ke objek, pilih opsi pencegahan akses publik dan kontrol akses yang ingin Anda gunakan.
Untuk Memilih cara melindungi data objek, pilih alat perlindungan yang ingin Anda gunakan sepertipembuatan versi objek, kebijakan retensi , danmetode enkripsi.
Klik Create.
Untuk mempelajari cara mendapatkan informasi error mendetail tentang operasi Cloud Storage yang gagal di Konsol Google Cloud, lihat Pemecahan masalah.
Command line
Gunakan perintah buckets create
dengan flag --location
dan --placement
:
gcloud storage buckets create gs://BUCKET_NAME --location=MULTI-REGION --placement=REGION_1,REGION_2
Dengan keterangan:
BUCKET_NAME
adalah nama bucket yang Anda buat. Misalnya,my-bucket
MULTI-REGION
menentukan kode multi-region yang terkait dengan region yang mendasarinya. Misalnya, saat memilih regionASIA-SOUTH1
(Mumbai) danASIA-SOUTH2
(Delhi), gunakanIN
.REGION_1
menentukan lokasi geografis region untuk bucket Anda. Contoh,ASIA-EAST1
.REGION_2
menentukan lokasi geografis region kedua untuk bucket Anda. Contoh,ASIA-SOUTHEAST1
.
Jika permintaan berhasil, perintah akan menampilkan pesan berikut:
Creating gs://BUCKET_NAME/...
Untuk daftar lengkap opsi yang tersedia saat membuat bucket dengan gcloud storage
, 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, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
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, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
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, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
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, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
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, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
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, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
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, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
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, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
REST API
JSON API
Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header
Authorization
.Buat file JSON yang berisi setelan untuk bucket, yang harus menyertakan
name
danlocation
. Lihat dokumentasi Buckets:Insert untuk daftar lengkap setelan. Berikut adalah setelan umum yang harus disertakan:{ "name": "BUCKET_NAME", "location": "MULTI-REGION", "customPlacementConfig": { "dataLocations": ["REGION_1", "REGION_2"] }, "storageClass": "STORAGE_CLASS" }
Dengan keterangan:
BUCKET_NAME
adalah nama yang ingin Anda berikan untuk bucket, tunduk pada persyaratan penamaan. Contohnya,my-bucket
.MULTI-REGION
menentukan kode multi-region yang terkait dengan region yang mendasarinya. Misalnya, saat memilih regionASIA-SOUTH1
(Mumbai) danASIA-SOUTH2
(Delhi), gunakanIN
.REGION_1
danREGION_2
adalah region tempat Anda ingin menyimpan data objek bucket. Misalnya,ASIA-EAST1
danASIA-SOUTHEAST1
.STORAGE_CLASS
adalah kelas penyimpanan dari 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_ID"
Dengan keterangan:
JSON_FILE_NAME
adalah nama file JSON yang Anda buat di Langkah 2.PROJECT_ID
adalah ID project yang akan dikaitkan dengan bucket Anda. Misalnya,my-project
XML API
Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header
Authorization
.Buat file XML yang berisi informasi berikut:
<CreateBucketConfiguration> <LocationConstraint>MULTI-REGION</LocationConstraint> <CustomPlacementConfig> <DataLocations> <DataLocation>REGION_1</DataLocation> <DataLocation>REGION_2</DataLocation> </DataLocations> </CustomPlacementConfig> <StorageClass>STORAGE_CLASS</StorageClass> </CreateBucketConfiguration>
Dengan keterangan:
MULTI-REGION
menentukan kode multi-region yang terkait dengan region yang mendasarinya. Misalnya, saat memilih regionASIA-SOUTH1
(Mumbai) danASIA-SOUTH2
(Delhi), gunakanIN
.REGION_1
danREGION_2
adalah region tempat Anda ingin menyimpan data objek bucket. Misalnya,ASIA-EAST1
danASIA-SOUTHEAST1
.STORAGE_CLASS
adalah kelas penyimpanan default untuk bucket Anda. Misalnya,STANDARD
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 keterangan:
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 menyertakan region yang tidak didukung, pesan error akan ditampilkan. Jika permintaan berhasil, respons tidak akan ditampilkan.
Langkah selanjutnya
- Pelajari replikasi turbo lebih lanjut.
- Mengambil metadata bucket, termasuk penyambungan region yang digunakan oleh bucket dual-region.
- Pelajari harga replikasi turbo lebih lanjut atau lihat contoh harga.