gunakan perintah revert-versioning untuk memulihkan versi file yang dihapus - Object Storage Service

Jalankan revert-versioning untuk mengembalikan objek yang dihapus di bucket yang telah diaktifkan Pengendalian versi ke versi terbaru sebelumnya.

Cara kerja

Saat Anda menghapus objek di bucket yang telah diaktifkan Pengendalian versi, OSS menyisipkan penanda hapus dan menyimpan semua versi sebelumnya tetap utuh. Perintah revert-versioning menghapus penanda hapus tersebut sehingga versi terbaru sebelumnya kembali menjadi versi saat ini.

Catatan: revert-versioning hanya berlaku pada objek yang memiliki penanda hapus sebagai versi saat ini. Jika suatu objek ditimpa (overwritten) alih-alih dihapus, perintah ini tidak akan berpengaruh.

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

Bucket OSS yang telah diaktifkan Pengendalian versi
Izin oss:ListObjectVersions dan oss:DeleteObjectVersion pada bucket target. Untuk detailnya, lihat Lampirkan kebijakan kustom ke RAM user.
ossutil terinstal. Untuk ossutil versi 1.6.16 ke atas, gunakan langsung ossutil sebagai nama biner. Untuk versi sebelumnya, sesuaikan nama biner berdasarkan sistem operasi Anda. Untuk detailnya, lihat Referensi perintah ossutil.

Sintaks

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

Parameter dan opsi

Parameter/Opsi	Deskripsi
`bucketname`	Nama bucket yang berisi objek yang akan dikembalikan.
`prefix`	Awalan untuk memfilter objek dan direktori berdasarkan nama.
`--encoding-type`	Jenis encoding untuk awalan yang mengikuti `oss://bucketname`. Nilai yang valid: `url`. Jika tidak ditentukan, awalan tidak di-encode.
`-r, --recursive`	Mengembalikan semua objek yang namanya sesuai dengan awalan yang ditentukan. Tanpa opsi ini, hanya objek yang ditentukan yang dikembalikan.
`--start-time`	Stempel waktu UNIX. Objek yang dihapus sebelum waktu ini tidak dikembalikan.
`--end-time`	Stempel waktu UNIX. Objek yang dihapus setelah waktu ini tidak dikembalikan.
`--include`	Hanya mengembalikan objek yang sesuai dengan pola yang ditentukan. Untuk detailnya, lihat Opsi --include dan --exclude.
`--exclude`	Melewati objek yang sesuai dengan pola yang ditentukan. Untuk detailnya, lihat Opsi --include dan --exclude.
`--payer`	Pihak yang membayar biaya operasi. Tetapkan ke `requester` untuk membebankan biaya trafik dan permintaan kepada pihak peminta.

Contoh

Mengembalikan satu objek

ossutil revert-versioning oss://examplebucket/exampleobject.jpg

Mengembalikan semua objek dengan awalan tertentu

ossutil revert-versioning oss://examplebucket/destdir -r

Mengembalikan semua objek yang dihapus dalam suatu bucket

ossutil revert-versioning oss://examplebucket -r

Mengembalikan objek yang dihapus dalam rentang waktu tertentu

Perintah berikut mengembalikan objek yang dihapus antara pukul 16.22.58 dan 16.39.38 pada 16 Juni 2020 (UTC+8):

ossutil revert-versioning oss://examplebucket -r --start-time 1592295778 --end-time 1592296778

Mengembalikan objek berdasarkan jenis file

Hanya mengembalikan objek TXT:

ossutil revert-versioning oss://examplebucket --include "*.txt" -r

Mengembalikan semua objek kecuali objek JPG:

ossutil revert-versioning oss://examplebucket --exclude "*.jpg" -r

Contoh output

Eksekusi yang berhasil akan mengembalikan jumlah objek yang dipulihkan serta waktu yang telah berlalu:

revert versioning object count is 10, batch list count is 10

0.066413(s) elapsed

Mengakses bucket di wilayah atau akun berbeda

Untuk mengakses bucket di wilayah berbeda, tambahkan -e untuk menentukan titik akhir bucket tersebut. Untuk mengakses bucket yang dimiliki oleh Akun Alibaba Cloud berbeda, tambahkan -i dan -k untuk menentukan ID AccessKey dan Rahasia AccessKey akun tersebut.

Perintah berikut mengembalikan exampletest.png di testbucket, yang berada di wilayah Tiongkok (Shanghai) dan dimiliki oleh akun berbeda:

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

Langkah selanjutnya

Ikhtisar — Pelajari cara kerja Pengendalian versi di OSS.
Penanda hapus — Pahami bagaimana penanda hapus memengaruhi pengambilan objek.