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

Gunakan perintah ossutil restore untuk memulihkan objek Archive, Cold Archive, atau Deep Cold Archive agar dapat diakses. Perintah ini mengirimkan pekerjaan pemulihan ke OSS, yang akan mencairkan objek tersebut dan membuatnya dapat dibaca selama periode yang dapat dikonfigurasi.

Dua cara untuk membuat objek arsip dapat diakses:

Pemulihan sementara (topik ini): Jalankan ossutil restore untuk mencairkan objek selama 1–365 hari. Objek kembali ke status beku ketika periode berakhir.
migrasi permanen: Jalankan ossutil cp untuk menyalin objek ke kelas penyimpanan non-arsip. Lihat Ubah kelas penyimpanan objek.

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

izin oss:RestoreObject untuk memulihkan satu objek
izin oss:RestoreObject dan oss:ListObjects untuk memulihkan objek berdasarkan direktori atau secara massal
ossutil versi 1.7.11 atau yang lebih baru (perintah restore tidak tersedia di versi sebelumnya)

Untuk pengaturan izin, lihat Lampirkan kebijakan kustom ke RAM user.

Untuk instalasi ossutil dan aturan penamaan biner, lihat Referensi perintah ossutil.

Cara kerja

Waktu pemulihan bervariasi tergantung kelas penyimpanan:

Kelas penyimpanan	Akses Real-time	Waktu pemulihan	Durasi maksimum pemulihan
Archive	Didukung (jika diaktifkan)	~1 menit	7 hari
Cold Archive	Tidak didukung	Beberapa jam (tergantung tier)	365 hari
Deep Cold Archive	Tidak didukung	12–48 jam (tergantung tier)	365 hari

Waktu pemulihan merupakan perkiraan dan dapat bervariasi berdasarkan ukuran objek dan beban sistem. Untuk detail penagihan, lihat Pulihkan objek.

Sintaksis 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>]

Parameter/Opsi	Deskripsi
`bucketname`	Bucket tempat objek disimpan.
`prefix`	Awalan untuk mencocokkan nama objek dalam bucket, seperti jalur direktori.
`local_xml_file`	File XML lokal yang menentukan parameter pemulihan. Wajib untuk objek Cold Archive dan Deep Cold Archive. Opsional untuk objek Archive.
`--encoding-type`	Metode encoding untuk nilai `prefix`. Nilai yang valid: `url`. Jika tidak ditentukan, awalan tidak di-encode.
`--payer`	Atur ke `requester` untuk mengaktifkan mode requester-pays, di mana pihak yang meminta membayar biaya trafik dan permintaan.
`--version-id`	ID versi objek yang akan dipulihkan. Hanya berlaku untuk bucket yang telah mengaktifkan Pengendalian versi atau menangguhkan Pengendalian versi.
`-r, --recursive`	Memulihkan semua objek yang namanya sesuai dengan awalan yang ditentukan. Tanpa opsi ini, hanya objek yang ditentukan yang dipulihkan.
`-f, --force`	Menjalankan perintah tanpa prompt konfirmasi.
`--object-file`	File TXT atau XML lokal yang berisi daftar nama objek yang akan dipulihkan, satu per baris. Jika terjadi error pada satu objek, ossutil mencatat error tersebut dan melanjutkan pemulihan objek lainnya. Objek yang berhasil dipulihkan tidak dicatat dalam file laporan.
`--snapshot-path`	Menghasilkan snapshot hanya untuk objek yang terlibat dalam operasi ini. Melewatkan objek yang sudah memiliki snapshot. Harus digunakan bersama `-r, --recursive` atau `--object-file`.
`--disable-ignore-error`	Berhenti mengabaikan error selama pemulihan batch.
`--retry-times`	Jumlah percobaan ulang setelah kegagalan perintah. Default: `10`. Nilai yang valid: 1–500.
`-j, --job`	Jumlah tugas pemulihan konkuren. Default: `3`. Nilai yang valid: 1–10000.

Pulihkan objek Archive

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

Restore Duration Behavior:

Durasi pemulihan default: 1 hari
Menjalankan kembali perintah restore pada objek yang sudah dipulihkan memperpanjang durasi sebesar 1 hari
Durasi maksimum pemulihan: 7 hari
Setelah periode berakhir, objek kembali ke status beku

Secara opsional, buat file config.xml untuk menentukan jumlah hari objek tetap dalam keadaan dipulihkan:

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

Pulihkan satu objek Archive

Pulihkan exampleobject.txt di examplebucket dan pertahankan dalam keadaan dipulihkan selama 3 hari:

ossutil restore oss://examplebucket/exampleobject.txt config.xml

Untuk memulihkan versi tertentu dari objek:

ossutil restore oss://examplebucket/exampleobject.txt --version-id CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3**** config.xml

Untuk menampilkan semua versi objek, lihat ls.

Pulihkan beberapa objek Archive

Pulihkan objek di direktori berbeda menggunakan `--object-file`:

Tulis nama objek ke file TXT, satu per baris:

   exampleobject1.jpg
   dir1/exampleobject2.png
   dir2/exampleobject3.txt

Atur durasi pemulihan di config.xml:

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

Jalankan perintah pemulihan:

   ossutil restore oss://examplebucket --object-file localfile.txt --snapshot-path dir/ config.xml

Pulihkan semua objek dalam direktori menggunakan `-r`:

ossutil restore oss://examplebucket/dest -r config.xml

Output yang diharapkan

Perintah pemulihan yang berhasil menghasilkan output waktu yang diperlukan:

0.106852(s) elapsed

Pulihkan objek Cold Archive

Penting

Waktu pemulihan objek Cold Archive bervariasi tergantung ukuran objek.

Sebelum memulihkan objek Cold Archive, buat file config.xml yang berisi durasi pemulihan dan tier pengambilan:

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

Pilih tier pengambilan berdasarkan tingkat urgensi:

Tier	Waktu pemulihan	Kapan digunakan
Expedited	Dalam waktu 1 jam	Akses mendesak diperlukan
Standard	2–5 jam	Jadwal pemulihan standar
Bulk	5–12 jam	Tidak mendesak

Nilai yang valid untuk <Days>: 1–365.

Pulihkan satu objek Cold Archive

Pulihkan exampleobject.jpg di examplebucket menggunakan tier dan durasi yang ditentukan dalam config.xml:

ossutil restore oss://examplebucket/exampleobject.jpg config.xml

Pulihkan beberapa objek Cold Archive

Pulihkan objek di direktori berbeda menggunakan `--object-file`:

Tulis nama objek ke file TXT, satu per baris:

   exampleobject1.jpg
   dir1/exampleobject2.png
   dir2/exampleobject3.txt

Jalankan perintah pemulihan:

   ossutil restore oss://examplebucket --object-file localfile.txt --snapshot-path dir/ config.xml

Pulihkan semua objek dalam direktori menggunakan `-r`:

ossutil restore oss://examplebucket/dest -r config.xml

Output yang diharapkan

0.106852(s) elapsed

Pulihkan objek Deep Cold Archive

Penting

Waktu pemulihan objek Deep Cold Archive bervariasi tergantung ukuran objek.

Sebelum memulihkan objek Deep Cold Archive, buat file config.xml yang berisi durasi pemulihan dan tier pengambilan:

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

Pilih tier pengambilan:

Tier	Waktu pemulihan	Kapan digunakan
Expedited	Dalam waktu 12 jam	Akses lebih cepat diperlukan
Standard	Dalam waktu 48 jam	Jadwal pemulihan standar

Nilai yang valid untuk <Days>: 1–365.

Pulihkan satu objek Deep Cold Archive

Pulihkan exampleobject.jpg di examplebucket menggunakan tier dan durasi yang ditentukan dalam config.xml:

ossutil restore oss://examplebucket/exampleobject.jpg config.xml

Pulihkan beberapa objek Deep Cold Archive

Pulihkan objek di direktori berbeda menggunakan `--object-file`:

Tulis nama objek ke file TXT, satu per baris:

   exampleobject1.jpg
   dir1/exampleobject2.png
   dir2/exampleobject3.txt

Jalankan perintah pemulihan:

   ossutil restore oss://examplebucket --object-file localfile.txt --snapshot-path dir/ config.xml

Pulihkan semua objek dalam direktori menggunakan `-r`:

ossutil restore oss://examplebucket/dest -r config.xml

Output yang diharapkan

0.106852(s) elapsed

Verifikasi status pemulihan

Setelah menjalankan perintah pemulihan, gunakan perintah stat untuk memeriksa apakah objek berada dalam keadaan dipulihkan:

ossutil stat oss://bucketname/objectname

Untuk detail selengkapnya, lihat stat.

Opsi umum

Untuk mengoperasikan bucket di wilayah berbeda atau di bawah Akun Alibaba Cloud yang berbeda, tambahkan opsi -e, -i, dan -k:

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

Opsi	Deskripsi
`-e`	Titik akhir wilayah tempat bucket berada.
`-i`	ID AccessKey Akun Alibaba Cloud target.
`-k`	Rahasia AccessKey Akun Alibaba Cloud target.

Untuk semua opsi yang tersedia, lihat Opsi umum.

Langkah selanjutnya

Untuk membuat objek selalu dapat diakses tanpa perlu memulihkannya setiap kali, salin objek tersebut ke kelas penyimpanan non-arsip. Lihat Apa yang harus saya lakukan agar objek selalu berada dalam keadaan dipulihkan?
Untuk detail proses pemulihan dan penagihan, lihat Pulihkan objek.