Cara menggunakan perintah revert untuk memulihkan versi objek yang dihapus - Object Storage Service

Anda dapat menjalankan perintah revert untuk memulihkan versi objek yang dihapus dalam bucket dengan fitur versioning aktif ke versi terbaru sebelumnya.

Catatan penggunaan

Untuk memulihkan versi objek, Anda harus memiliki izin oss:GetObject, oss:PutObject, oss:ListObjectVersions, dan oss:DeleteObject. Untuk informasi selengkapnya, lihat Lampirkan kebijakan kustom ke RAM user.
Untuk informasi selengkapnya tentang versioning, lihat Versioning.
Untuk informasi selengkapnya tentang delete marker, lihat Delete marker.

Sintaksis perintah

ossutil revert oss://bucket[/prefix] version-directive [flags]

Parameter	Tipe	Deskripsi
version-directive	string	Versi objek yang dihapus yang ingin Anda pulihkan. Nilai yang valid: ID versi. Contoh: CAEQIBiBgICAr6yv9hgiIDZiNmUzNjM5Njg0ZDRhOWQ4Yj. Indeks versi. Format: HEAD~n. Versi objek dipulihkan ke versi valid ke-(n-1), tidak termasuk delete marker. Jika indeks versi diatur ke HEAD~0, versi objek dipulihkan ke versi sebelumnya yang paling baru. Jika versi terbaru adalah delete marker, versi objek dipulihkan ke versi sebelumnya yang paling baru dengan menghapus delete marker tersebut. Jika indeks versi diatur ke HEAD~n (n > 0), versi objek dipulihkan ke versi sebelumnya yang paling baru dengan menyalin versi objek tersebut. Indeks waktu. Format: NOW~waktu relatif atau NOW~waktu absolut. Versi objek dipulihkan ke versi sebelumnya yang paling baru yang waktu modifikasi terakhirnya tidak lebih baru dari waktu yang ditentukan, tidak termasuk delete marker. NOW~ waktu relatif: Saat menggunakan pengindeksan waktu relatif, Anda dapat mundur ke interval waktu tertentu dari waktu lokal saat ini. Formatnya adalah `NOW~` diikuti oleh akhiran satuan waktu. Akhiran satuan yang didukung adalah: ms untuk milidetik, s untuk detik, m untuk menit, h untuk jam, d untuk hari, w untuk minggu, M untuk bulan, dan y untuk tahun. Contoh: `NOW~1d` berarti memulihkan ke versi satu hari sebelum waktu lokal saat ini. NOW~ waktu absolut: Untuk kasus yang memerlukan tanggal dan waktu spesifik, Anda dapat menggunakan indeks waktu absolut. Formatnya adalah `NOW~` diikuti oleh string waktu yang sesuai dengan standar ISO 8601 (`YYYY-MM-DDTHH:mm:ss`), yang akan memulihkan versi paling baru sebelum waktu lokal yang ditentukan. Contoh: `NOW~2024-04-12T14:00:00` menunjukkan bahwa versi objek dipulihkan ke versi sebelumnya yang paling baru yang waktu modifikasi terakhirnya tidak lebih baru dari pukul 14:00:00, 12 April 2024.
-d, --dirs	/	Menentukan bahwa objek dan subdirektori dalam direktori saat ini dikembalikan.
--encoding-type	string	Metode encoding yang digunakan untuk mengencode nama objek. Nilai yang valid: url.
--end-with	string	Menentukan bahwa objek yang namanya secara alfabetis sebelum atau sama dengan nilai parameter --end-with dikembalikan.
--exclude	stringArray	Aturan pengecualian untuk path atau nama objek.
--exclude-from	stringArray	Menentukan bahwa aturan pengecualian dibaca dari file aturan.
--files-from	stringArray	Menentukan bahwa nama objek sumber dibaca dari file aturan, dan baris kosong atau baris komentar diabaikan.
--files-from-raw	stringArray	Menentukan bahwa nama objek sumber dibaca dari file aturan.
--filter	stringArray	Aturan filter untuk path atau nama objek.
--filter-from	stringArray	Menentukan bahwa aturan filter untuk path atau nama objek dibaca dari file aturan.
-f, --force	/	Menentukan bahwa perintah dijalankan secara paksa tanpa prompt konfirmasi.
--ignore-version-not-exist	/	Menentukan bahwa error yang menunjukkan versi tidak ada diabaikan dalam operasi batch.
--include	stringArray	Aturan penyertaan untuk path atau nama objek.
--include-from	stringArray	Menentukan bahwa aturan penyertaan dibaca dari file aturan.
--max-age	Durasi	Hanya memulihkan objek yang waktu modifikasi terakhirnya berada dalam durasi yang ditentukan. Satuan default adalah detik. Anda juga dapat menggunakan akhiran, seperti 1h untuk satu jam. Catatan `--min-age 1h` menunjukkan bahwa hanya objek yang dimodifikasi dalam satu jam terakhir yang dipulihkan.
--min-mtime	Waktu	Hanya memulihkan objek yang waktu modifikasi terakhirnya setelah waktu yang ditentukan. Contoh: 2006-01-02T15:04:05. Catatan `--min-mtime "2006-01-02T15:04:05"` menunjukkan bahwa hanya file yang dimodifikasi setelah 2006-01-02 15:04:05 yang dipulihkan.
--page-size	int	Jumlah maksimum objek yang ditampilkan per permintaan API selama operasi batch. Nilai default: 1000. Rentang nilai: 1 hingga 1000.
-r, --recursive	/	Menentukan bahwa perintah dijalankan secara rekursif pada objek. Jika parameter ini ditentukan, perintah revert berlaku untuk semua objek yang memenuhi kondisi dalam bucket. Jika tidak, perintah revert hanya berlaku untuk objek dalam path yang ditentukan.
--request-payer	string	Pihak yang membayar permintaan. Jika pay-by-requester diaktifkan untuk bucket, atur parameter ini ke requester. Nilai yang valid: requester.
--start-after	string	Menentukan bahwa objek yang namanya secara alfabetis setelah nilai parameter --start-after dikembalikan.

Catatan

Untuk informasi selengkapnya, lihat Opsi command-line.

Catatan: Perintah revert tidak dapat digunakan untuk menghapus versi objek guna memulihkan objek ke versi tertentu. Untuk memulihkan objek ke versi tertentu dengan menghapus versi lainnya, gunakan perintah rm. Misalnya, jalankan perintah berikut untuk menghapus tiga versi terbaru sebelumnya dari objek bernama key123:

ossutil rm oss://bucket/key123 --end-with key123 --limited-num 3 -rf --all-versions

Contoh

Memulihkan versi yang dihapus dari satu objek

Pulihkan objek example.txt yang dihapus dalam bucket examplebucket ke versi dengan ID versi 123:
```
ossutil revert oss://examplebucket/example.txt 123
```
Pulihkan objek example.txt yang dihapus dalam bucket examplebucket ke versi terbaru sebelumnya:
```
ossutil revert oss://examplebucket/example.txt HEAD~0
```
Pulihkan objek example.txt yang dihapus dalam bucket examplebucket ke versi keempat terbaru sebelumnya:
```
ossutil revert oss://examplebucket/example.txt HEAD~4
```
Pulihkan objek example.txt yang dihapus dalam bucket examplebucket ke versi terbaru sebelumnya pada hari sebelumnya:
```
ossutil revert oss://examplebucket/example.txt NOW~1d
```
Pulihkan objek example.txt yang dihapus dalam bucket examplebucket ke versi terbaru sebelumnya yang waktu modifikasi terakhirnya tidak lebih baru dari 2024-04-12T14:00:00:
```
ossutil revert oss://examplebucket/example.txt NOW~2024-04-12T14:00:00
```

Memulihkan versi yang dihapus dari beberapa objek

Pulihkan semua objek dalam direktori dir di bucket examplebucket ke versi keempat terbaru sebelumnya:
```
ossutil revert oss://examplebucket/dir -r HEAD~4
```
Pulihkan semua objek dalam direktori dir di bucket examplebucket ke versi keempat terbaru sebelumnya dan abaikan error yang menunjukkan versi tidak ada:
```
ossutil revert oss://examplebucket/dir -r HEAD~4 --ignore-version-not-exist
```
Pulihkan semua objek kecuali objek dengan format JPG di bucket examplebucket ke versi terbaru sebelumnya:
```
ossutil revert oss://examplebucket -r --exclude "*.jpg" HEAD~0
```
Pulihkan semua objek dengan ekstensi .txt dalam direktori dir1 dan dir2 di bucket examplebucket ke versi terbaru sebelumnya:
```
ossutil revert oss://examplebucket -r --include "/dir1/*.txt" --include "/dir2/*.txt" HEAD~0
```
Baca aturan penyertaan dari file include_rules.txt dan pulihkan objek yang memenuhi aturan tersebut dalam direktori dir di bucket examplebucket ke versi keempat terbaru sebelumnya:
Konten file aturan include_rules.txt adalah sebagai berikut:
```
*.log
*.csv
```
Contoh perintah:
```
ossutil revert oss://examplebucket/dir -r HEAD~4 --include-from include_rules.txt
```