Jalankan perintah revert-versioning untuk mengembalikan versi objek. - Object Storage Service

Tema ini menjelaskan cara menjalankan perintah revert-versioning untuk mengembalikan objek dalam bucket dengan versioning ke versi sebelumnya yang paling baru.

Catatan penggunaan

Untuk mengembalikan versi objek, Anda memerlukan izin oss:ListObjectVersions dan oss:DeleteObjectVersion. Untuk informasi lebih lanjut, lihat Melampirkan Kebijakan Kustom ke Pengguna RAM.
Mulai ossutil versi 1.6.16, Anda dapat langsung menggunakan ossutil sebagai nama biner di baris perintah tanpa perlu menyesuaikannya berdasarkan sistem operasi. Untuk versi sebelum 1.6.16, Anda harus menyesuaikan nama biner sesuai sistem operasi. Untuk informasi lebih lanjut, lihat Referensi Perintah ossutil.

Untuk informasi lebih lanjut tentang versioning, lihat Ikhtisar.
Untuk informasi lebih lanjut tentang penanda hapus, lihat Penanda Hapus.

Sintaks perintah

ossutil revert-versioning oss://namabucket[/prefix]
[--encoding-type <nilai>]
[-r, --recursive]
[--start-time <nilai> ]
[--end-time <nilai>]
[--include <nilai>]
[--exclude <nilai>]
[--payer <nilai>]

Tabel berikut menjelaskan parameter dan opsi dalam sintaks.

Parameter/Opsi	Deskripsi
namabucket	Nama bucket yang berisi objek yang ingin Anda pulihkan.
prefix	Awalan dalam nama sumber daya, seperti direktori dan objek.
--encoding-type	Pengkodean dari awalan yang mengikuti `oss://nama_bucket`. Nilai valid: url. Jika Anda tidak menentukan opsi ini, awalan tidak dikodekan.
-r, --recursive	Jika Anda menentukan opsi ini, ossutil akan memulihkan semua objek yang namanya mengandung awalan yang ditentukan oleh opsi awalan ke versi sebelumnya yang paling baru. Jika Anda tidak menentukan opsi ini, ossutil hanya akan memulihkan objek yang ditentukan ke versi sebelumnya yang paling baru.
--start-time	Awal rentang waktu untuk menyaring objek. Nilainya adalah timestamp UNIX. Jika Anda menentukan opsi ini, objek yang dihapus sebelum waktu ini tidak akan dipulihkan.
--end-time	Akhir rentang waktu untuk menyaring objek. Nilainya adalah timestamp UNIX. Jika Anda menentukan opsi ini, objek yang dihapus setelah waktu ini tidak akan dipulihkan.
--include	Memasukkan semua objek yang memenuhi kondisi yang ditentukan. Untuk informasi lebih lanjut, lihat Opsi --include dan --exclude.
--exclude	Mengecualikan semua objek yang memenuhi kondisi yang ditentukan. Untuk informasi lebih lanjut, lihat Opsi --include dan --exclude.
--payer	Pembayar biaya yang dihasilkan oleh operasi. Jika Anda ingin peminta yang mengakses sumber daya di jalur yang ditentukan membayar biaya lalu lintas dan permintaan, atur opsi ini ke requester.

Contoh

Perintah Contoh
- Kembalikan objek exampleobject.jpg yang dihapus di bucket examplebucket ke versi sebelumnya yang paling baru.
```
ossutil revert-versioning oss://examplebucket/exampleobject.jpg
```
- Kembalikan beberapa objek yang dihapus yang disimpan di bucket examplebucket dan nama-namanya mengandung awalan destdir yang ditentukan ke versi sebelumnya yang paling baru dengan menentukan opsi -r.
```
ossutil revert-versioning oss://examplebucket/destdir -r
```
- Kembalikan semua objek yang dihapus di bucket examplebucket ke versi sebelumnya yang paling baru dengan menentukan opsi -r.
```
ossutil revert-versioning oss://examplebucket  -r
```
- Kembalikan objek yang dihapus selama periode waktu tertentu ke versi sebelumnya yang paling baru.
  Kembalikan objek yang dihapus dari 16:22:58 hingga 16:39:38 pada 16 Juni 2020 (UTC+8) dari bucket examplebucket ke versi sebelumnya yang paling baru dengan menentukan opsi -r.
```
ossutil revert-versioning oss://examplebucket -r --start-time 1592295778 --end-time 1592296778
```
- Kembalikan semua objek yang dihapus yang memenuhi kondisi yang ditentukan ke versi sebelumnya yang paling baru.
  - Kembalikan semua objek TXT yang dihapus di bucket examplebucket ke versi sebelumnya yang paling baru dengan menentukan opsi -r.
```
ossutil revert-versioning oss://examplebucket --include "*.txt" -r
```
  - Kembalikan semua objek yang dihapus di bucket examplebucket, kecuali objek JPG, ke versi sebelumnya yang paling baru dengan menentukan opsi -r.
```
ossutil revert-versioning oss://examplebucket --exclude "*.jpg" -r
```
Output Contoh
Respon sukses mencakup jumlah objek yang dipulihkan dan waktu yang digunakan untuk pemulihan. Contoh:
```
revert versioning object count is 10, batch list count is 10

0.066413(s) elapsed
```

Opsi umum

Jika Anda menggunakan ossutil untuk beralih ke bucket yang terletak 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 mengembalikan objek exampletest.png di bucket testbucket ke versi sebelumnya yang paling baru. Bucket testbucket terletak di wilayah Tiongkok (Shanghai) dan dimiliki oleh akun Alibaba Cloud lain.

ossutil revert-versioning oss://testbucket/exampletest.png -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret