Gunakan perintah restore untuk memulihkan objek Archive, Cold Archive, dan Deep Cold Archive OSS - Object Storage Service

Objek Archive harus dipulihkan sebelum dapat dibaca, kecuali jika akses Real-time diaktifkan. Akses Real-time tidak didukung untuk objek Cold Archive dan Deep Cold Archive, sehingga objek tersebut wajib dipulihkan terlebih dahulu sebelum dapat dibaca. Proses pemulihan objek Archive umumnya memerlukan waktu beberapa menit, objek Cold Archive memerlukan beberapa jam, sedangkan objek Deep Cold Archive memerlukan 12 hingga 48 jam. Waktu pemulihan aktual mungkin bervariasi. Topik ini menjelaskan cara menggunakan perintah restore untuk memulihkan objek.

Catatan

Untuk memulihkan satu objek, Anda memerlukan izin oss:RestoreObject. Untuk memulihkan beberapa objek dalam folder, Anda memerlukan izin oss:RestoreObject dan oss:ListObjects. Untuk informasi selengkapnya, lihat Memberikan izin kustom kepada RAM user.
Mulai ossutil 1.6.16, Anda dapat menggunakan ossutil sebagai nama binary di command line terlepas dari sistem operasi yang digunakan. Jika Anda menggunakan versi ossutil sebelum 1.6.16, ubah nama binary sesuai dengan sistem operasi Anda. Untuk informasi selengkapnya, lihat Referensi perintah ossutil.
Untuk informasi selengkapnya mengenai status pemulihan dan penagihan objek Archive, Cold Archive, atau Deep Cold Archive, lihat Memulihkan objek.
Perintah ini hanya tersedia pada ossutil 1.7.11 dan versi yang lebih baru.

Sintaks perintah

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

Tabel berikut menjelaskan parameter dan opsi dalam perintah tersebut.

Parameter	Deskripsi
bucketname	Nama bucket.
prefix	Sumber daya dalam bucket dapat mencakup folder dan file.
local_xml_file	File XML lokal yang menyimpan parameter pemulihan untuk objek Cold Archive.
--encoding-type	Metode pengkodean untuk awalan. Tetapkan nilainya menjadi url. Jika Anda tidak menentukan opsi ini, awalan tidak akan dikodekan.
--payer	Pembayar untuk permintaan tersebut. Agar pemohon menanggung biaya seperti traffic dan permintaan, tetapkan opsi ini ke requester.
--version-id	ID versi objek. Opsi ini hanya berlaku untuk objek dalam bucket yang telah mengaktifkan atau menangguhkan Pengendalian versi.
-r, --recursive	Memulihkan semua objek yang sesuai dengan awalan. Jika Anda tidak menentukan opsi ini, ossutil hanya memulihkan objek yang ditentukan.
-f, --force	Memaksa operasi tanpa prompt konfirmasi.
--object-file	Memulihkan multiple objek Archive, Cold Archive, atau Deep Cold Archive secara Batch. Untuk menggunakan opsi ini: Tentukan file lokal dalam format .txt atau XML. Di dalam file tersebut, cantumkan daftar semua objek yang akan dipulihkan, dengan setiap objek pada baris baru. ossutil membaca semua objek dari file lokal dan memulihkannya secara Batch. Catatan Jika terjadi error saat memulihkan objek, ossutil mencatat informasi error tersebut ke dalam file laporan dan melanjutkan pemulihan objek lainnya. Informasi tentang objek yang berhasil dipulihkan tidak dicatat dalam file laporan.
--snapshot-path	Membuat Snapshot hanya untuk objek dalam operasi saat ini. Jika Snapshot sudah ada untuk objek tersebut, operasi ini akan diabaikan. Catatan Opsi ini harus digunakan bersama dengan opsi -r, --recursive atau --object-file.
--disable-ignore-error	Tidak mengabaikan error selama operasi batch.
--retry-times	Jumlah percobaan ulang jika terjadi error. Nilai default: 10. Rentang nilai: 1 hingga 500.
-j, --job	Jumlah tugas konkuren untuk operasi pada multiple objek. Nilai default: 3. Rentang nilai: 1 hingga 10.000.

Memulihkan objek Archive

Pemulihan objek Archive memerlukan waktu sekitar satu menit. Objek tidak dapat dibaca selama proses pemulihan berlangsung.

Secara default, objek yang dipulihkan tetap berada dalam keadaan dipulihkan selama satu hari. Jika Anda menjalankan perintah restore pada objek yang sudah dipulihkan, durasi keadaan dipulihkan akan diperpanjang sesuai jumlah hari yang ditentukan dalam parameter Days pada permintaan pemulihan (default: 1 hari jika tidak ada config.xml yang disediakan). Keadaan dipulihkan dapat diperpanjang maksimal hingga tujuh hari. Setelah periode ini berakhir, objek akan kembali ke status beku.

Catatan

Anda dapat menggunakan perintah cp untuk mengubah kelas penyimpanan objek. Untuk informasi selengkapnya, lihat Menyalin objek dan mengubah kelas penyimpanannya.

Saat memulihkan objek Archive, Anda juga dapat membuat file XML lokal bernama config.xml untuk mengonfigurasi durasi keadaan dipulihkan.

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

Memulihkan satu objek Archive
- Contoh berikut menunjukkan cara memulihkan objek Archive bernama exampleobject.txt di bucket examplebucket dan mempertahankan objek dalam keadaan dipulihkan selama tiga hari.
```
ossutil restore oss://examplebucket/exampleobject.txt config.xml
```
- Contoh berikut menunjukkan cara memulihkan versi tertentu dari objek Archive bernama exampleobject.txt di bucket examplebucket.
```
ossutil restore oss://examplebucket/exampleobject.txt --version-id  CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3**** config.xml
```
  Untuk informasi selengkapnya tentang cara mendapatkan semua versi objek, lihat ls (Mencantumkan sumber daya tingkat akun).
Memulihkan beberapa objek Archive
- Contoh 1: Objek di folder yang berbeda
  Untuk memulihkan beberapa objek Archive yang berada di folder berbeda dalam bucket examplebucket, seperti exampleobject1.jpg di folder root, exampleobject2.png di folder dir1/, dan exampleobject3.txt di folder dir2/, lakukan langkah-langkah berikut.
  1. Tuliskan nama objek Archive yang ingin dipulihkan ke dalam file lokal localfile.txt.
```
exampleobject1.jpg
dir1/exampleobject2.png
dir2/exampleobject3.txt
```
  2. Dalam file config.xml, atur durasi keadaan dipulihkan menjadi tiga hari.
```
<RestoreRequest>
    <Days>3</Days>
</RestoreRequest>
```
  3. Pulihkan beberapa objek Archive.
    
    Gunakan opsi --object-file untuk memulihkan beberapa objek Archive di bucket examplebucket.
```
ossutil restore oss://examplebucket --object-file localfile.txt --snapshot-path dir/ config.xml
```
- Contoh 2: Objek dalam folder yang sama
  - Metode 1
    
    Anda dapat merujuk ke Contoh 1 untuk memulihkan beberapa objek Archive dalam folder yang sama di sebuah bucket.
  - Metode 2
    Gunakan opsi -r untuk memulihkan semua objek Archive dari folder dest yang ditentukan di bucket examplebucket.
```
ossutil restore oss://examplebucket/dest -r config.xml
```
Output

Jika operasi berhasil, output akan menampilkan waktu inisiasi permintaan pemulihan. Contoh:
```
0.106852(s) elapsed
```

Memulihkan objek Cold Archive

Penting

Waktu pemulihan aktual bervariasi tergantung pada ukuran objek.

Sebelum memulihkan satu atau lebih objek Cold Archive, buat file XML lokal bernama config.xml dan konfigurasikan parameter pemulihan berikut di dalamnya.

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

Tabel berikut menjelaskan parameter tersebut.

Parameter

Deskripsi

Days

Jumlah hari objek Cold Archive yang dipulihkan tetap berada dalam keadaan dipulihkan. Satuan: hari.

Rentang nilai: 1 hingga 365

Tier

Prioritas pemulihan untuk objek Cold Archive.

Nilai yang valid:

Expedited (prioritas tinggi): Objek dipulihkan dalam waktu 1 jam.
Standard: Objek dipulihkan dalam waktu 2 hingga 5 jam.
Bulk: Objek dipulihkan dalam waktu 5 hingga 12 jam.

Catatan

Prioritas pemulihan yang berbeda berkaitan dengan biaya permintaan Pengambilan data dan biaya kapasitas Pengambilan data yang berbeda pula, di mana prioritas Expedited menimbulkan biaya tertinggi. Untuk informasi selengkapnya, lihat Biaya permintaan.

Memulihkan satu objek Cold Archive

Perintah berikut memulihkan objek exampleobject.jpg di bucket examplebucket dalam waktu 1 jam dan mempertahankan objek dalam keadaan dipulihkan selama tiga hari, berdasarkan konfigurasi dalam file config.xml.
```
ossutil restore oss://examplebucket/exampleobject.jpg config.xml
```
Memulihkan beberapa objek Cold Archive
- Contoh 1: Objek di folder yang berbeda
  Untuk memulihkan beberapa objek Cold Archive yang berada di folder berbeda dalam bucket examplebucket, seperti exampleobject1.jpg di folder root, exampleobject2.png di folder dir1/, dan exampleobject3.txt di folder dir2/, lakukan langkah-langkah berikut.
  1. Tuliskan nama objek Cold Archive yang akan dipulihkan ke dalam file lokal localfile.txt.
```
exampleobject1.jpg
dir1/exampleobject2.png
dir2/exampleobject3.txt
```
  2. Pulihkan beberapa objek.
    
    Gunakan opsi --object-file untuk memulihkan beberapa objek Cold Archive di bucket examplebucket. Berdasarkan konfigurasi dalam file config.xml, objek dipulihkan dalam waktu 1 jam dan dipertahankan dalam keadaan dipulihkan selama tiga hari.
```
ossutil restore oss://examplebucket --object-file localfile.txt --snapshot-path dir/ config.xml
```
- Contoh 2: Objek dalam folder yang sama
  - Metode 1
    
    Anda dapat merujuk ke Contoh 1 untuk memulihkan beberapa objek Cold Archive dalam folder yang sama di sebuah bucket.
  - Metode 2
    Gunakan opsi -r untuk memulihkan semua objek Cold Archive dari folder dest di bucket examplebucket.
```
ossutil restore oss://examplebucket/dest -r config.xml
```
Output

Jika operasi berhasil, output akan menampilkan waktu inisiasi permintaan pemulihan. Contoh:
```
0.106852(s) elapsed
```

Memulihkan objek Deep Cold Archive

Penting

Waktu pemulihan aktual bergantung pada ukuran objek.

Sebelum memulihkan satu atau lebih objek Deep Cold Archive, buat file XML lokal bernama config.xml dan konfigurasikan parameter pemulihan berikut di dalamnya.

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

Parameter konfigurasi adalah sebagai berikut:

Parameter

Deskripsi

Days

Jumlah hari objek Deep Cold Archive yang dipulihkan tetap berada dalam keadaan dipulihkan. Satuan: hari.

Rentang nilai: 1 hingga 365

Tier

Prioritas pemulihan untuk objek Deep Cold Archive.

Nilai yang valid:

Expedited (prioritas tinggi): Objek dipulihkan dalam waktu 12 jam.
Standard: Objek dipulihkan dalam waktu 48 jam.

Catatan

Memulihkan satu objek Deep Cold Archive

Berdasarkan konfigurasi dalam file config.xml, perintah berikut memulihkan objek exampleobject.jpg di bucket examplebucket dalam waktu 48 jam dan mempertahankannya dalam keadaan dipulihkan selama tiga hari.
```
ossutil restore oss://examplebucket/exampleobject.jpg config.xml
```
Memulihkan beberapa objek Deep Cold Archive
- Contoh 1: Objek di folder yang berbeda
  Untuk memulihkan beberapa objek Deep Cold Archive yang berada di folder berbeda dalam bucket examplebucket, seperti exampleobject1.jpg di folder root, exampleobject2.png di folder dir1/, dan exampleobject3.txt di folder dir2/, lakukan langkah-langkah berikut.
  1. Tambahkan nama objek Deep Cold Archive yang akan dipulihkan ke dalam file lokal localfile.txt.
```
exampleobject1.jpg
dir1/exampleobject2.png
dir2/exampleobject3.txt
```
  2. Pulihkan beberapa objek.
    
    Gunakan opsi --object-file untuk memulihkan beberapa objek Deep Cold Archive di bucket examplebucket dalam waktu 48 jam dan mempertahankannya dalam keadaan dipulihkan selama tiga hari. Operasi ini didasarkan pada konfigurasi dalam file config.xml.
```
ossutil restore oss://examplebucket --object-file localfile.txt --snapshot-path dir/ config.xml
```
- Contoh 2: Objek dalam folder yang sama
  - Metode 1
    
    Anda dapat merujuk ke Contoh 1 untuk memulihkan beberapa objek Deep Cold Archive dalam folder yang sama di sebuah bucket.
  - Metode 2
    Gunakan opsi -r untuk memulihkan semua objek Deep Cold Archive di folder dest bucket examplebucket.
```
ossutil restore oss://examplebucket/dest -r config.xml
```
Output

Jika operasi berhasil, output akan menampilkan waktu inisiasi permintaan pemulihan. Contoh:
```
0.106852(s) elapsed
```

Opsi umum

Untuk mengakses bucket di Wilayah yang berbeda, gunakan -e untuk menentukan Titik akhir. Untuk mengakses bucket yang dimiliki oleh Akun Alibaba Cloud yang berbeda, gunakan -i untuk ID AccessKey dan -k untuk Rahasia AccessKey.

Sebagai contoh, untuk memulihkan objek exampletest.png di bucket testbucket yang berada di Wilayah China (Shanghai) dan dimiliki oleh Akun Alibaba Cloud lain, jalankan perintah berikut:

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

Opsi umum.

Referensi

Untuk memeriksa apakah suatu objek telah dipulihkan, lihat stat (Melihat informasi bucket dan objek).
Agar objek OSS tetap terpulihkan secara permanen, lihat Bagaimana cara menjaga objek OSS tetap terpulihkan secara permanen?.