全部产品
Search
文档中心

Object Storage Service:bucket-versioning

更新时间:Jul 02, 2025

Jika Anda ingin dapat mengembalikan objek ke versi sebelumnya setelah secara tidak sengaja tertimpa atau dihapus, jalankan perintah bucket-versioning untuk mengaktifkan versioning. Object Storage Service (OSS) memungkinkan Anda mengonfigurasi versioning pada bucket untuk melindungi objek di dalamnya. Setelah mengaktifkan versioning, objek yang tertimpa atau dihapus disimpan sebagai versi sebelumnya.

Catatan penggunaan

  • Untuk mengonfigurasi versioning, Anda memerlukan izin oss:PutBucketVersioning. Untuk menanyakan status versioning, Anda memerlukan izin oss:GetBucketVersioning. Untuk informasi lebih lanjut, lihat Lampirkan Kebijakan Kustom ke Pengguna RAM.

  • Untuk ossutil versi 1.6.16 dan yang lebih baru, Anda dapat langsung menggunakan ossutil sebagai nama biner di baris perintah tanpa perlu memperbarui nama biner berdasarkan sistem operasi. Untuk versi sebelum 1.6.16, Anda harus memperbarui nama biner sesuai dengan sistem operasi. Untuk informasi lebih lanjut, lihat Referensi Perintah ossutil.

  • Untuk informasi lebih lanjut tentang versioning, lihat Versioning.

Konfigurasikan versioning

  • Sintaks Perintah

    ossutil bucket-versioning --method put oss://namabucket versioning

    Tabel berikut menjelaskan parameter dalam sintaks perintah.

    Parameter

    Deskripsi

    namabucket

    Nama bucket yang ingin Anda konfigurasi versioning-nya.

    versioning

    Status versioning bucket. Nilai valid:

    • enabled: mengaktifkan versioning untuk bucket. Saat objek diunggah ke bucket dengan versioning aktif, OSS menghasilkan string acak sebagai ID versi global unik untuk objek tersebut. Untuk informasi lebih lanjut, lihat Kelola objek di bucket dengan versioning aktif.

    • suspended: menangguhkan versioning untuk bucket. Saat objek diunggah ke bucket dengan versioning ditangguhkan, OSS menghasilkan ID versi null untuk objek yang diunggah. Untuk informasi lebih lanjut, lihat Kelola objek di bucket dengan versioning ditangguhkan.

    Penting

    Secara default, status versioning bucket adalah tanpa versioning. Setelah versioning diaktifkan untuk bucket, status versioning bucket tidak dapat diatur kembali ke tanpa versioning. Namun, Anda dapat menangguhkan versioning untuk bucket dengan versioning aktif.

  • Contoh

    Jalankan perintah berikut untuk mengaktifkan versioning pada bucket bernama examplebucket:

    ossutil bucket-versioning --method put oss://examplebucket enabled

    Jalankan perintah berikut untuk menangguhkan versioning pada bucket bernama examplebucket:

    ossutil bucket-versioning --method put oss://examplebucket suspended

    Output sampel berikut menunjukkan bahwa versioning telah dikonfigurasi untuk bucket:

    0.261209(s) elapsed

Periksa status versioning bucket

  • Sintaks Perintah

    ossutil bucket-versioning --method get oss://namabucket
  • Contoh

    Jalankan perintah berikut untuk memeriksa status versioning bucket bernama examplebucket:

    ossutil bucket-versioning --method get oss://examplebucket

    Output sampel berikut menunjukkan bahwa versioning diaktifkan untuk bucket:

    status versioning bucket:Enabled
    
    0.218001(s) elapsed

    Output sampel berikut menunjukkan bahwa versioning ditangguhkan untuk bucket:

    status versioning bucket:Suspended
    
    0.168791(s) elapsed

    Output sampel berikut menunjukkan bahwa status versioning adalah tanpa versioning:

    status versioning bucket:Null
    
    0.158691(s) elapsed

Operasi terkait

  • Pengunggahan ke bucket dengan versioning aktif berperilaku sama seperti pengunggahan ke bucket tanpa versioning, kecuali bahwa OSS menghasilkan ID versi global unik untuk objek yang diunggah ke bucket dengan versioning aktif. Untuk informasi lebih lanjut, lihat Unggah Objek.

  • Setelah mengaktifkan versioning untuk bucket, objek yang tertimpa atau dihapus disimpan sebagai versi sebelumnya. Anda dapat menentukan ID versi untuk mengunduh versi tertentu dari objek. Untuk informasi lebih lanjut, lihat Unduh Objek. Anda juga dapat menentukan ID versi untuk memulihkan versi sebelumnya dari objek. Untuk informasi lebih lanjut, lihat Salin Objek.

Opsi umum

Jika Anda menggunakan ossutil untuk beralih ke bucket yang berada di wilayah lain, tambahkan opsi -e untuk menentukan titik akhir wilayah tempat bucket berada. Jika Anda menggunakan ossutil untuk beralih ke bucket yang dimiliki oleh akun Alibaba Cloud lain, tambahkan opsi -i untuk menentukan ID AccessKey dari akun tersebut, dan tambahkan opsi -k untuk menentukan Rahasia AccessKey dari akun tersebut.

Sebagai contoh, Anda dapat menjalankan perintah berikut untuk mengaktifkan versioning pada bucket bernama examplebucket, yang berada di wilayah China (Hangzhou) dan dimiliki oleh akun Alibaba Cloud lain:

ossutil bucket-versioning--method put oss://examplebucket enabled -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Untuk informasi lebih lanjut tentang opsi umum, lihat Opsi Umum.