Jalankan perintah pulihkan untuk memulihkan objek Arsip, Penyimpanan Arsip Dingin, dan Deep Cold Archive - Object Storage Service

Anda dapat mengakses objek Arsip setelah mengaktifkan akses real-time atau memulihkannya. Akses real-time tidak tersedia untuk objek Penyimpanan Arsip Dingin dan Deep Cold Archive; Anda hanya dapat mengaksesnya setelah pemulihan. Pemulihan objek Arsip biasanya memerlukan beberapa menit, Penyimpanan Arsip Dingin memerlukan beberapa jam, sedangkan Deep Cold Archive memerlukan waktu antara 12 hingga 48 jam. Durasi ini bersifat perkiraan dan dapat bervariasi tergantung pada skenario aktual. Topik ini menjelaskan cara menjalankan perintah restore untuk memulihkan objek.

Catatan penggunaan

Untuk memulihkan satu objek, Anda memerlukan izin oss:RestoreObject. Untuk memulihkan objek berdasarkan direktori, Anda memerlukan izin oss:RestoreObject dan oss:ListObjects. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.
Mulai dari ossutil versi 1.6.16, Anda dapat menggunakan nama biner langsung di baris perintah tanpa memperbarui berdasarkan sistem operasi. Untuk versi sebelum 1.6.16, Anda harus menyesuaikan nama biner sesuai dengan sistem operasi. Untuk detail lebih lanjut, lihat Referensi Perintah ossutil.
Untuk informasi lebih lanjut tentang proses pemulihan dan aturan penagihan, lihat Memulihkan Objek.
Perintah restore didukung mulai ossutil versi 1.7.11.

Sintaks perintah

ossutil restore oss://namabucket[/prefix][file_xml_lokal]
[--encoding-type <nilai>]
[--payer <nilai>]
[--version-id <nilai>]
[-r, --recursive]
[-f, --force] 
[--object-file, <nilai>]
[--snapshot-path, <nilai>]
[--disable-ignore-error]
[--retry-times <nilai>]
[-j, --job <nilai>]

Tabel berikut menjelaskan parameter dan opsi dalam sintaks perintah.

Parameter/Opsi	Deskripsi
namabucket	Nama bucket tempat objek yang ingin Anda pulihkan disimpan.
prefix	Awalan dalam nama sumber daya di bucket, seperti direktori dan objek.
file_xml_lokal	File XML lokal yang menyimpan parameter untuk memulihkan objek Penyimpanan Arsip Dingin.
--encoding-type	Metode yang digunakan untuk mengkodekan nilai parameter prefix. Nilai valid: url. Jika Anda tidak menentukan opsi ini, nilai parameter prefix tidak dikodekan.
--payer	Pembayar permintaan. Jika Anda ingin pihak yang mengakses sumber daya di jalur tertentu membayar biaya yang dihasilkan oleh operasi, seperti lalu lintas dan biaya permintaan, atur parameter ini ke requester.
--version-id	ID versi objek yang ingin Anda hapus. Parameter ini hanya berlaku untuk bucket dengan versioning aktif atau ditangguhkan.
-r, --recursive	Jika Anda menentukan opsi ini, ossutil memulihkan semua objek yang namanya mengandung awalan tertentu di bucket. Jika Anda tidak menentukan opsi ini, ossutil hanya memulihkan objek yang ditentukan.
-f, --force	Menentukan bahwa perintah dijalankan secara paksa tanpa konfirmasi.
--object-file	File yang berisi nama objek Arsip, Penyimpanan Arsip Dingin, atau Deep Cold Archive yang ingin Anda pulihkan sekaligus. Untuk menggunakan opsi ini, lakukan langkah-langkah berikut: Tentukan file TXT atau XML lokal. Kemudian, masukkan nama semua objek yang ingin Anda pulihkan di file tersebut, dengan masing-masing nama objek pada baris terpisah. Atur --object-file ke nama file TXT atau XML lokal dan kemudian jalankan perintah. ossutil membaca semua nama objek dalam file lokal dan memulihkan objek tersebut. Catatan Jika kesalahan pemulihan dikembalikan untuk salah satu objek, ossutil mencatat informasi kesalahan tentang objek tersebut dalam file laporan dan melanjutkan untuk memulihkan objek lainnya. Informasi tentang objek yang dipulihkan tidak dicatat dalam file laporan.
--snapshot-path	Jika Anda menentukan opsi ini, ossutil hanya menghasilkan snapshot untuk objek yang terlibat dalam operasi ini. Jika snapshot sudah dihasilkan untuk objek yang terlibat dalam operasi ini, tidak ada snapshot yang dihasilkan untuk objek dalam operasi ini. Catatan Opsi ini harus digunakan bersama dengan -r, --recursive atau --object-file.
--disable-ignore-error	Menentukan bahwa kesalahan tidak diabaikan untuk pemulihan batch.
--retry-times	Jumlah percobaan ulang setelah perintah gagal dijalankan. Nilai default: 10. Nilai valid: 1 hingga 500.
-j, --job	Jumlah tugas konkuren yang dilakukan di beberapa objek. Nilai valid: 1 hingga 10000. Nilai default: 3.

Memulihkan objek Arsip

OSS membutuhkan waktu sekitar 1 menit untuk memulihkan objek Arsip. Objek tidak dapat dibaca selama proses pemulihan.

Secara default, objek yang telah dipulihkan tetap dalam status dipulihkan selama satu hari. Jika Anda menjalankan perintah restore untuk objek yang sudah dalam status dipulihkan, durasi diperpanjang selama satu hari lagi. Anda dapat mempertahankan objek dalam status dipulihkan hingga tujuh hari. Setelah periode tersebut berakhir, objek kembali ke status beku.

Catatan

Gunakan perintah cp untuk mengubah kelas penyimpanan objek. Untuk informasi lebih lanjut, lihat Mengubah Kelas Penyimpanan Objek.

Saat memulihkan objek Arsip, buat file config.xml dan tentukan jumlah hari objek akan tetap dalam status dipulihkan. Contoh kode berikut memberikan ilustrasi:

<RestoreRequest>
    <Days>3</Days>
</RestoreRequest>

Memulihkan Satu Objek Arsip
- Contoh kode berikut menunjukkan cara memulihkan objek Arsip bernama exampleobject.txt di bucket examplebucket dan mempertahankannya dalam status dipulihkan selama tiga hari:
```
ossutil restore oss://examplebucket/exampleobject.txt config.xml
```
- Contoh kode berikut menunjukkan cara memulihkan versi tertentu dari objek Arsip bernama exampleobject.txt di bucket examplebucket:
```
ossutil restore oss://examplebucket/exampleobject.txt --version-id  CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3**** config.xml
```
  Untuk informasi lebih lanjut tentang mencantumkan semua versi objek, lihat Is.
Memulihkan Beberapa Objek Arsip Sekaligus
- Contoh 1: Memulihkan Beberapa Objek Arsip di Direktori Berbeda
  Misalkan Anda ingin memulihkan objek Arsip berikut di direktori berbeda dalam bucket examplebucket: exampleobject1.jpg di direktori root, exampleobject2.png di direktori dir1/, dan exampleobject3.txt di direktori dir2/. Ikuti langkah-langkah berikut:
  1. Tulis nama objek Arsip yang ingin dipulihkan ke file localfile.txt.
```
exampleobject1.jpg
dir1/exampleobject2.png
dir2/exampleobject3.txt
```
  2. Dalam file config.xml, tentukan bahwa objek tetap dalam status dipulihkan selama tiga hari.
```
<RestoreRequest>
    <Days>3</Days>
</RestoreRequest>
```
  3. Pulihkan objek Arsip.
    Perintah berikut menunjukkan cara memulihkan beberapa objek Arsip di examplebucket menggunakan opsi --object-file:
```
ossutil restore oss://examplebucket --object-file localfile.txt --snapshot-path dir/ config.xml
```
- Contoh 2: Memulihkan Beberapa Objek Arsip di Direktori yang Sama
  - Metode 1
    Langkah-langkah untuk memulihkan beberapa objek Arsip di direktori yang sama serupa dengan yang dijelaskan di Contoh 1: Memulihkan Beberapa Objek Arsip di Direktori Berbeda.
  - Metode 2
    Perintah berikut menunjukkan cara memulihkan semua objek Arsip di direktori dest dalam examplebucket menggunakan opsi -r:
```
ossutil restore oss://examplebucket/dest -r config.xml
```
Contoh Keluaran
Jika perintah berhasil, keluaran akan mencakup baris serupa berikut untuk menunjukkan waktu pemulihan yang dikonsumsi:
```
0.106852(s) elapsed
```

Memulihkan objek Penyimpanan Arsip Dingin

Penting

Waktu pemulihan objek Penyimpanan Arsip Dingin bervariasi tergantung ukuran objek.

Sebelum memulihkan satu atau lebih objek Penyimpanan Arsip Dingin, buat file XML config.xml secara lokal dan konfigurasikan parameter berikut dalam file tersebut:

<RestoreRequest>
    <Days>3</Days>
    <JobParameters>
        <Tier>Bulk</Tier>
    </JobParameters>
</RestoreRequest>

Tabel berikut menjelaskan parameter.

Parameter

Deskripsi

Days

Durasi Anda ingin menjaga objek Penyimpanan Arsip Dingin yang telah dipulihkan dalam status dipulihkan. Unit: hari.

Nilai valid: 1 hingga 365.

Tier

Prioritas pemulihan objek Penyimpanan Arsip Dingin.

Nilai valid:

Expedited: Objek dipulihkan dalam waktu 1 jam.
Standard: Objek dipulihkan dalam 2 hingga 5 jam.
Bulk: Objek dipulihkan dalam 5 hingga 12 jam.

Memulihkan Satu Objek Penyimpanan Arsip Dingin
Perintah berikut menunjukkan cara memulihkan objek exampleobject.jpg di bucket examplebucket dalam waktu 1 jam dan mempertahankannya dalam status dipulihkan selama tiga hari berdasarkan konfigurasi di file config.xml:
```
ossutil restore oss://examplebucket/exampleobject.jpg config.xml
```
Memulihkan Beberapa Objek Penyimpanan Arsip Dingin Sekaligus
- Contoh 1: Memulihkan Beberapa Objek Penyimpanan Arsip Dingin di Direktori Berbeda
  Misalkan Anda ingin memulihkan objek Penyimpanan Arsip Dingin berikut di direktori berbeda dalam bucket examplebucket: exampleobject1.jpg di direktori root, exampleobject2.png di direktori dir1/, dan exampleobject3.txt di direktori dir2/. Ikuti langkah-langkah berikut:
  1. Tulis nama objek Penyimpanan Arsip Dingin yang ingin dipulihkan ke file localfile.txt.
```
exampleobject1.jpg
dir1/exampleobject2.png
dir2/exampleobject3.txt
```
  2. Pulihkan objek.
    Perintah berikut menunjukkan cara memulihkan beberapa objek Penyimpanan Arsip Dingin dalam bucket examplebucket dalam waktu 1 jam menggunakan opsi --object-file dan mempertahankannya dalam status dipulihkan selama tiga hari berdasarkan konfigurasi di file config.xml:
```
ossutil restore oss://examplebucket --object-file localfile.txt --snapshot-path dir/ config.xml
```
- Contoh 2: Memulihkan Beberapa Objek Penyimpanan Arsip Dingin di Direktori yang Sama
  - Metode 1
    Langkah-langkah untuk memulihkan beberapa objek Penyimpanan Arsip Dingin di direktori yang sama serupa dengan yang dijelaskan di Contoh 1: Memulihkan Beberapa Objek Penyimpanan Arsip Dingin di Direktori Berbeda.
  - Metode 2
    Perintah berikut menunjukkan cara memulihkan semua objek Penyimpanan Arsip Dingin di direktori dest dalam bucket examplebucket menggunakan opsi -r:
```
ossutil restore oss://examplebucket/dest -r config.xml
```
Contoh Keluaran
Jika perintah berhasil, keluaran akan mencakup baris serupa berikut untuk menunjukkan waktu pemulihan yang dikonsumsi:
```
0.106852(s) elapsed
```

Memulihkan objek Deep Cold Archive

Penting

Waktu pemulihan objek Deep Cold Archive bervariasi tergantung ukuran objek.

Sebelum memulihkan satu atau lebih objek Deep Cold Archive, buat file XML config.xml secara lokal dan konfigurasikan parameter berikut dalam file tersebut:

<RestoreRequest>
    <Days>3</Days>
    <JobParameters>
        <Tier>Standard</Tier>
    </JobParameters>
</RestoreRequest>

Tabel berikut menjelaskan parameter.

Parameter

Deskripsi

Days

Durasi Anda ingin menjaga objek Deep Cold Archive yang telah dipulihkan dalam status dipulihkan. Unit: hari.

Nilai valid: 1 hingga 365.

Tier

Mode pemulihan objek Deep Cold Archive.

Nilai valid:

Expedited: Objek dipulihkan dalam waktu 12 jam.
Standard: Objek dipulihkan dalam waktu 48 jam.

Memulihkan Satu Objek Deep Cold Archive
Perintah berikut menunjukkan cara memulihkan exampleobject.jpg di bucket examplebucket dalam waktu 48 jam dan mempertahankannya dalam status dipulihkan selama tiga hari berdasarkan konfigurasi di file config.xml:
```
ossutil restore oss://examplebucket/exampleobject.jpg config.xml
```
Memulihkan Beberapa Objek Deep Cold Archive Sekaligus
- Contoh 1: Memulihkan Beberapa Objek Deep Cold Archive di Direktori Berbeda
  Misalkan Anda ingin memulihkan objek Deep Cold Archive berikut di direktori berbeda dalam bucket examplebucket: exampleobject1.jpg di direktori root, exampleobject2.png di direktori dir1/, dan exampleobject3.txt di direktori dir2/. Ikuti langkah-langkah berikut:
  1. Tulis nama objek Deep Cold Archive ke file localfile.txt.
```
exampleobject1.jpg
dir1/exampleobject2.png
dir2/exampleobject3.txt
```
  2. Pulihkan objek.
    Perintah berikut menunjukkan cara memulihkan beberapa objek Deep Cold Archive dalam bucket examplebucket dalam waktu 48 jam menggunakan opsi --object-file dan mempertahankannya dalam status dipulihkan selama tiga hari berdasarkan konfigurasi di file config.xml:
```
ossutil restore oss://examplebucket --object-file localfile.txt --snapshot-path dir/ config.xml
```
- Contoh 2: Memulihkan Beberapa Objek Deep Cold Archive di Direktori yang Sama
  - Metode 1
    Langkah-langkah untuk memulihkan beberapa objek Deep Cold Archive di direktori yang sama serupa dengan yang dijelaskan di Contoh 1: Memulihkan Beberapa Objek Deep Cold Archive di Direktori Berbeda.
  - Metode 2
    Perintah berikut menunjukkan cara memulihkan semua objek Deep Cold Archive di direktori dest dalam examplebucket menggunakan opsi -r:
```
ossutil restore oss://examplebucket/dest -r config.xml
```
Contoh Keluaran
Jika perintah berhasil, keluaran akan mencakup baris serupa berikut untuk menunjukkan waktu pemulihan yang dikonsumsi:
```
0.106852(s) elapsed
```

Opsi umum

Jika Anda menggunakan ossutil untuk beralih ke bucket di wilayah lain, tambahkan opsi -e untuk menentukan endpoint wilayah tempat bucket berada. Jika Anda beralih ke bucket milik akun Alibaba Cloud lain, tambahkan opsi -i untuk menentukan ID AccessKey akun tersebut, serta opsi -k untuk menentukan rahasia AccessKey.

Sebagai contoh, Anda dapat menjalankan perintah berikut untuk memulihkan objek bernama exampletest.png di bucket testbucket yang berada di wilayah China (Shanghai) dan dimiliki oleh akun Alibaba Cloud lain:

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

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

Referensi

Untuk informasi lebih lanjut tentang cara memeriksa apakah objek telah dipulihkan, lihat stat.
Untuk informasi lebih lanjut tentang cara menjaga objek tetap permanen dalam status dipulihkan, lihat Apa yang harus saya lakukan agar objek tetap permanen dalam status dipulihkan?