Halaman ini menjelaskan cara mengaktifkan, menonaktifkan, dan memeriksa status Pembuatan Versi Objek di bucket. Lihat Menggunakan objek berversi untuk mempelajari cara mencantumkan, memulihkan, dan menghapus objek yang dipertahankan oleh Pembuatan Versi Objek.
Izin yang diperlukan
Konsol
Untuk menyelesaikan panduan ini menggunakan Konsol Google Cloud, Anda harus memiliki izin IAM yang sesuai. Jika bucket yang ingin Anda akses ada di project yang tidak Anda buat, Anda mungkin perlu meminta pemilik project untuk memberi Anda peran yang berisi izin yang diperlukan.
Guna mengetahui daftar izin yang diperlukan untuk tindakan tertentu, lihat Izin IAM untuk Konsol Google Cloud.
Untuk daftar peran yang relevan, lihat peran Cloud Storage. Atau, Anda dapat membuat peran khusus yang memiliki izin khusus dan terbatas.
Command line
Untuk menyelesaikan panduan ini menggunakan utilitas command line, Anda harus memiliki izin IAM yang sesuai. Jika bucket yang ingin Anda akses ada di project yang tidak Anda buat, Anda mungkin perlu meminta pemilik project untuk memberi Anda peran yang berisi izin yang diperlukan.
Guna mengetahui daftar izin yang diperlukan untuk tindakan tertentu, lihat Izin IAM untuk perintah gsutil.
Untuk daftar peran yang relevan, lihat peran Cloud Storage. Atau, Anda dapat membuat peran khusus yang memiliki izin khusus dan terbatas.
Library klien
Untuk menyelesaikan panduan ini menggunakan library klien Cloud Storage, Anda harus memiliki izin IAM yang sesuai. Jika bucket yang ingin Anda akses ada dalam project yang tidak Anda buat, Anda mungkin perlu meminta pemilik project untuk memberi Anda peran yang berisi izin yang diperlukan.
Kecuali jika dinyatakan lain, permintaan library klien dibuat melalui JSON API dan memerlukan izin seperti yang tercantum dalam Izin IAM untuk metode JSON. Untuk melihat metode JSON API mana yang dipanggil saat Anda membuat permintaan menggunakan library klien, buat log permintaan mentah.
Untuk daftar peran IAM yang relevan, lihat peran Cloud Storage. Atau, Anda dapat membuat peran khusus yang memiliki izin khusus dan terbatas.
REST API
JSON API
Untuk menyelesaikan panduan ini menggunakan JSON API, Anda harus memiliki izin IAM yang sesuai. Jika bucket yang ingin Anda akses ada di project yang tidak Anda buat, Anda mungkin perlu meminta pemilik project untuk memberi Anda peran yang berisi izin yang diperlukan.
Guna mengetahui daftar izin yang diperlukan untuk tindakan tertentu, lihat Izin IAM untuk metode JSON.
Untuk daftar peran yang relevan, lihat peran Cloud Storage. Atau, Anda dapat membuat peran khusus yang memiliki izin khusus dan terbatas.
Menetapkan Pembuatan Versi Objek di bucket
Konsol
- Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.
Di daftar bucket, klik nama bucket tempat Anda ingin mengaktifkan atau menonaktifkan Pembuatan Versi Objek.
Pilih tab Perlindungan di dekat bagian atas halaman.
Status Pembuatan versi objek saat ini dapat ditemukan di bagian Pembuatan versi objek
Di bagian Pembuatan versi objek, klik status saat ini untuk melakukan perubahan padanya.
Kotak dialog Pembuatan versi objek akan muncul.
- Jika Anda mengaktifkan Pembuatan Versi Objek dan ingin meminimalkan biaya penyimpanan, centang kotak Tambahkan aturan siklus proses yang direkomendasikan untuk mengelola biaya versi.
Klik Confirm.
Command line
gcloud
Gunakan perintah gcloud storage buckets update
dengan flag yang sesuai:
gcloud storage buckets update gs://BUCKET_NAME FLAG
Dengan keterangan:
BUCKET_NAME
adalah nama bucket yang relevan. Contoh,my-bucket
.FLAG
adalah--versioning
untuk mengaktifkan Pembuatan Versi Objek atau--no-versioning
untuk menonaktifkannya.
Jika berhasil, responsnya akan terlihat mirip dengan contoh berikut ini:
Updating gs://my-bucket/... Completed 1
gsutil
Gunakan perintah gsutil versioning set
:
gsutil versioning set STATE gs://BUCKET_NAME
Dengan keterangan:
STATE
adalahon
untuk mengaktifkan Pembuatan Versi Objek atauoff
untuk menonaktifkan Pembuatan Versi Objek.BUCKET_NAME
adalah nama bucket yang relevan. Contoh,my-bucket
.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Guna mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut mengaktifkan Pembuatan Versi Objek di bucket:
Contoh berikut menonaktifkan Pembuatan Versi Objek di bucket:
C#
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi Cloud Storage C# API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Guna mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut mengaktifkan Pembuatan Versi Objek di bucket:
Contoh berikut menonaktifkan Pembuatan Versi Objek di bucket:
Go
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi Cloud Storage Go API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Guna mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut mengaktifkan Pembuatan Versi Objek di bucket:
Contoh berikut menonaktifkan Pembuatan Versi Objek di bucket:
Java
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Guna mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut mengaktifkan Pembuatan Versi Objek di bucket:
Contoh berikut menonaktifkan Pembuatan Versi Objek di bucket:
Node.js
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi Cloud Storage Node.js API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Guna mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut mengaktifkan Pembuatan Versi Objek di bucket:
Contoh berikut menonaktifkan Pembuatan Versi Objek di bucket:
PHP
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi Cloud Storage PHP API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Guna mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut mengaktifkan Pembuatan Versi Objek di bucket:
Contoh berikut menonaktifkan Pembuatan Versi Objek di bucket:
Python
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi Cloud Storage Python API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Guna mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut mengaktifkan Pembuatan Versi Objek di bucket:
Contoh berikut menonaktifkan Pembuatan Versi Objek di bucket:
Ruby
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi Cloud Storage Ruby API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Guna mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut mengaktifkan Pembuatan Versi Objek di bucket:
Contoh berikut menonaktifkan Pembuatan Versi Objek di bucket:
REST API
JSON API
- Dapatkan token akses otorisasi dari OAuth 2.0 Playground. Konfigurasikan Playground agar menggunakan kredensial OAuth Anda sendiri. Untuk mendapatkan petunjuk, lihat Autentikasi API.
Buat file JSON yang berisi informasi berikut:
{ "versioning": { "enabled": STATE } }
Dengan STATE adalah
true
ataufalse
.Gunakan
cURL
untuk memanggil JSON API dengan permintaanPATCH
Bucket:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=versioning"
Dengan keterangan:
JSON_FILE_NAME
adalah jalur untuk file JSON yang Anda buat pada Langkah 2.OAUTH2_TOKEN
adalah token akses yang Anda buat pada Langkah 1.BUCKET_NAME
adalah nama bucket yang relevan. Contoh,my-bucket
.
XML API
- Dapatkan token akses otorisasi dari OAuth 2.0 Playground. Konfigurasikan Playground agar menggunakan kredensial OAuth Anda sendiri. Untuk mendapatkan petunjuk, lihat Autentikasi API.
Buat file XML yang berisi informasi berikut:
<VersioningConfiguration> <Status>STATE</Status> </VersioningConfiguration>
Dengan STATE adalah
Enabled
atauSuspended
.Gunakan
cURL
untuk memanggil XML API, dengan permintaanPUT
Bucket dan parameter string kueriversioning
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?versioning"
Dengan keterangan:
XML_FILE_NAME
adalah jalur untuk file XML yang Anda buat pada Langkah 2.OAUTH2_TOKEN
adalah token akses yang Anda buat pada Langkah 1.BUCKET_NAME
adalah nama bucket yang relevan. Contoh,my-bucket
.
Setelah Pembuatan Versi Objek diaktifkan, setiap kali versi objek aktif diganti atau dihapus, versi tersebut menjadi versi lama.
Memeriksa apakah Pembuatan Versi Objek diaktifkan
Untuk memeriksa apakah Pembuatan Versi Objek diaktifkan pada bucket:
Konsol
- Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.
Dalam daftar bucket, status Pembuatan Versi Objek untuk setiap bucket ditemukan di kolom Perlindungan.
Jika diaktifkan, teks Pembuatan versi objek akan muncul.
Command line
gcloud
Gunakan perintah gcloud storage buckets describe
dengan flag --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(versioning)"
Dengan BUCKET_NAME
yang merupakan nama bucket
yang statusnya ingin Anda lihat. Contoh, my-bucket
.
Jika berhasil, responsnya akan terlihat mirip dengan contoh berikut ini:
versioning: enabled: true
gsutil
Gunakan perintah gsutil versioning get
:
gsutil versioning get gs://BUCKET_NAME
Dengan BUCKET_NAME
yang merupakan nama bucket yang relevan. Contoh, my-bucket
.
Responsnya akan terlihat seperti berikut jika Pembuatan Versi Objek diaktifkan:
gs://my-bucket: Enabled
REST API
JSON API
- Dapatkan token akses otorisasi dari OAuth 2.0 Playground. Konfigurasikan Playground agar menggunakan kredensial OAuth Anda sendiri. Untuk mendapatkan petunjuk, lihat Autentikasi API.
Gunakan
cURL
untuk memanggil JSON API dengan permintaanGET
Bucket:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=versioning"
Dengan keterangan:
OAUTH2_TOKEN
adalah token akses yang Anda buat pada Langkah 1.BUCKET_NAME
adalah nama bucket yang relevan. Contoh,my-bucket
.
XML API
- Dapatkan token akses otorisasi dari OAuth 2.0 Playground. Konfigurasikan Playground agar menggunakan kredensial OAuth Anda sendiri. Untuk mendapatkan petunjuk, lihat Autentikasi API.
Gunakan
cURL
untuk memanggil XML API, dengan permintaanGET
Bucket dan parameter string kueriversioning
:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?versioning"
Dengan keterangan:
OAUTH2_TOKEN
adalah token akses yang Anda buat pada Langkah 1.BUCKET_NAME
adalah nama bucket yang relevan. Contoh,my-bucket
.
Langkah berikutnya
- Pelajari Pembuatan Versi Objek lebih lanjut.
- Pelajari cara menggunakan objek lama.
- Pelajari cara menggunakan Object Lifecycle Management untuk mengelola versi objek secara otomatis.
- Pelajari cara menggunakan prasyarat permintaan untuk mencegah kondisi race.