Halaman ini menjelaskan cara menggunakan fitur replikasi turbo pada bucket dual-region.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan guna menggunakan replikasi turbo, minta
administrator untuk memberi Anda peran IAM Storage Admin (roles/storage.admin
) di bucket.
Peran bawaan ini berisi izin yang diperlukan untuk menggunakan replikasi turbo. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
storage.buckets.get
storage.buckets.update
storage.buckets.list
- Izin ini hanya diperlukan jika Anda berencana menggunakan konsol Google Cloud untuk menjalankan petunjuk di halaman ini.
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran yang telah ditetapkan sebelumnya lainnya.
Untuk petunjuk cara memberikan peran pada bucket, lihat Menggunakan IAM dengan bucket.
Menetapkan replikasi turbo
Untuk mengaktifkan atau menonaktifkan replikasi turbo pada bucket yang ada, selesaikan petunjuk berikut:
Konsol
- Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.
Di daftar bucket, klik nama bucket yang diinginkan.
Klik tab Configuration.
Di baris Replikasi, klik
Edit.Jendela yang muncul menunjukkan apakah Anda akan Mengaktifkan replikasi turbo atau Menonaktifkan replikasi turbo.
Klik Simpan untuk mengonfirmasi setelan baru.
Command line
Gunakan perintah gcloud storage buckets update
dengan flag --rpo
:
gcloud storage buckets update gs://BUCKET_NAME --rpo=STATE
Dengan keterangan:
BUCKET_NAME
adalah nama bucket yang relevan. Contoh,my-bucket
.STATE
adalahASYNC_TURBO
untuk mengaktifkan Replikasi Turbo atauDEFAULT
untuk menonaktifkan Replikasi Turbo.
Jika berhasil, responsnya akan terlihat seperti ini:
Updating gs://my-bucket/... Completed 1
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mengaktifkan replikasi turbo pada bucket:
Contoh berikut mengaktifkan replikasi default pada bucket:
C#
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C# API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mengaktifkan replikasi turbo pada bucket:
Contoh berikut mengaktifkan replikasi default pada bucket:
Go
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Go API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mengaktifkan replikasi turbo pada bucket:
Contoh berikut mengaktifkan replikasi default pada bucket:
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mengaktifkan replikasi turbo pada bucket:
Contoh berikut mengaktifkan replikasi default pada bucket:
Node.js
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mengaktifkan replikasi turbo pada bucket:
Contoh berikut mengaktifkan replikasi default pada bucket:
PHP
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mengaktifkan replikasi turbo pada bucket:
Contoh berikut mengaktifkan replikasi default pada bucket:
Python
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mengaktifkan replikasi turbo pada bucket:
Contoh berikut mengaktifkan replikasi default pada bucket:
Ruby
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Ruby API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mengaktifkan replikasi turbo pada bucket:
Contoh berikut mengaktifkan replikasi default pada bucket:
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI , yang memungkinkan Anda membuat token akses untuk header
Authorization
.Buat file JSON yang berisi informasi berikut:
{ "rpo": "STATE" }
Dengan
STATE
adalahASYNC_TURBO
untuk mengaktifkan Replikasi Turbo atauDEFAULT
untuk menonaktifkan Replikasi Turbo.Gunakan
cURL
untuk memanggil JSON API dengan permintaan BucketPATCH
:curl -X PATCH --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/BUCKET_NAME?fields=rpo"
Dengan keterangan:
JSON_FILE_NAME
adalah jalur untuk file JSON yang Anda buat di Langkah 2.BUCKET_NAME
adalah nama bucket yang relevan. Contoh,my-bucket
.
Jika permintaan berhasil, tidak ada respons yang ditampilkan.
XML API
Fitur ini tidak dapat dikelola melalui XML API. Sebagai gantinya, gunakan JSON API.
Memeriksa status replikasi bucket
Untuk memeriksa toleransi durasi kehilangan data (RPO) atau status replikasi bucket, selesaikan petunjuk berikut:
Konsol
- Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.
Di daftar bucket, klik nama bucket yang ingin Anda verifikasi.
Klik tab Configuration.
Jika replikasi turbo diaktifkan pada bucket, Replikasi ditetapkan ke Turbo.
Command line
Gunakan perintah gcloud storage buckets describe
dengan
flag --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(rpo)"
Dengan keterangan:
BUCKET_NAME
adalah nama bucket yang relevan. Contoh,my-bucket
.
Jika berhasil, responsnya akan terlihat seperti contoh berikut:
rpo: ASYNC_TURBO
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk 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 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 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 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 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 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 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 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
.Gunakan
cURL
untuk memanggil JSON API dengan permintaan BucketGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
Dengan
BUCKET_NAME
adalah nama bucket yang relevan. Contoh,my-bucket
.Responsnya akan terlihat seperti contoh berikut:
{ "name": "my-bucket", "projectNumber": "234...", ... "rpo": "ASYNC_TURBO" }
Perhatikan tombol
rpo
. NilaiASYNC_TURBO
menunjukkan bahwa replikasi turbo diaktifkan.DEFAULT
menunjukkan bahwa replikasi default diterapkan. Kolomrpo
selalu ada untuk bucket dual-region dan multi-region, tetapi tidak ada di bucket single-region.
XML API
Fitur ini tidak dapat dikelola melalui XML API. Sebagai gantinya, gunakan JSON API.
Langkah selanjutnya
- Pelajari replikasi turbo lebih lanjut.
- Pelajari harga replikasi turbo lebih lanjut.
- Pelajari metrik yang memantau performa bucket Anda, termasuk performa replikasi.
- Pelajari cara pemberitahuan Cloud Monitoring dapat digunakan untuk membuat kebijakan perubahan berdasarkan metrik yang ditentukan dan mengelola notifikasi yang terkait dengan kebijakan tersebut.