restore-object - - 阿里云

Perintah restore-object digunakan untuk memulihkan objek dalam kelas penyimpanan Archive atau Cold Archive.

Catatan Penggunaan

Secara default, Akun Alibaba Cloud memiliki izin untuk menjalankan pemulihan objek. Jika Anda adalah Pengguna Resource Access Management (RAM) atau menggunakan Token Layanan Keamanan (STS), Anda harus memiliki izin oss:RestoreObject. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.
Perintah restore-object hanya berlaku untuk objek dalam kelas penyimpanan Archive atau Cold Archive dan tidak dapat digunakan untuk objek Standard atau Infrequent Access (IA).
Untuk mengakses objek Archive atau Cold Archive, Anda harus terlebih dahulu memulihkannya. Proses pemulihan objek Archive memerlukan waktu sekitar satu menit, sedangkan pemulihan objek Cold Archive bisa memakan waktu beberapa jam.

Penagihan

Pemulihan objek akan dikenakan biaya penyimpanan, biaya pengambilan data, dan biaya permintaan. Jika Anda memulihkan objek Cold Archive atau Deep Cold Archive, biaya penyimpanan sementara juga akan diterapkan.

Biaya penyimpanan: Biaya ini dihitung berdasarkan kelas penyimpanan objek selama dan setelah proses pemulihan. Untuk informasi lebih lanjut, lihat Biaya Penyimpanan.
Biaya pengambilan data: Pemulihan objek dari kelas penyimpanan Archive, Cold Archive, atau Deep Cold Archive akan dikenakan biaya pengambilan data. Untuk informasi lebih lanjut, lihat Biaya Pemrosesan Data.
Biaya permintaan:
- Memulihkan objek Archive akan dikenakan biaya untuk permintaan PUT. Untuk informasi lebih lanjut, lihat Biaya Permintaan.
- Memulihkan objek Cold Archive atau Deep Cold Archive akan dikenakan biaya untuk permintaan pengambilan. Untuk informasi lebih lanjut, lihat Biaya Permintaan.
Biaya penyimpanan sementara: Saat memulihkan objek Cold Archive atau Deep Cold Archive, salinan objek dibuat untuk akses sementara. Salinan ini dikenakan biaya penyimpanan dengan tarif kelas Standar hingga status dipulihkan berakhir. Untuk informasi lebih lanjut, lihat Biaya Penyimpanan Sementara.

Proses

Berikut adalah langkah-langkah pemulihan yang berlaku untuk objek dalam kelas penyimpanan Archive, Cold Archive, dan Deep Cold Archive:

Objek awalnya berada dalam status beku.
Setelah permintaan pemulihan dikirimkan, objek masuk ke status pemulihan.
Setelah server OSS menyelesaikan tugas pemulihan, objek masuk ke status dipulihkan dan dapat diakses.
Anda dapat mengajukan permintaan pemulihan tambahan pada objek dalam status dipulihkan untuk memperpanjang durasinya. Durasi status dipulihkan tidak boleh melebihi batas maksimum yang didukung oleh kelas penyimpanan yang sesuai.
Setelah durasi status dipulihkan berakhir, objek kembali ke status beku tanpa mengubah kelas penyimpanannya.

Waktu Pemulihan

Tabel berikut menunjukkan waktu yang diperlukan untuk memulihkan objek dalam kelas penyimpanan yang berbeda. Waktu pemulihan yang diberikan bersifat referensi; waktu aktual dapat bervariasi tergantung pada skenario tertentu.

Kelas penyimpanan	Deskripsi
Archive	1 menit.
Cold Archive	Expedited: Objek dipulihkan dalam waktu 1 jam. Standard: Objek dipulihkan dalam waktu 2 hingga 5 jam. Bulk: Objek dipulihkan dalam waktu 5 hingga 12 jam.
Deep Cold Archive	Expedited: Objek dipulihkan dalam waktu 12 jam. Standard: Objek dipulihkan dalam waktu 48 jam.

Kuota Pemulihan

Kuota referensi untuk memulihkan objek Cold Archive untuk Akun Alibaba Cloud di wilayah tertentu adalah rata-rata 500 objek per detik, dengan total 100 TB hingga 120 TB per hari untuk ketiga prioritas pemulihan.Jika bisnis Anda memerlukan kuota pemulihan yang lebih tinggi, hubungi dukungan teknis.
Kuota referensi untuk memulihkan objek Deep Cold Archive untuk Akun Alibaba Cloud di wilayah tertentu adalah rata-rata 100 objek per detik, dengan total 10 TB hingga 15 TB per hari untuk kedua prioritas pemulihan.Jika bisnis Anda memerlukan kuota pemulihan yang lebih tinggi, hubungi dukungan teknis.

Catatan

Anda masih dapat mengirimkan permintaan pemulihan setelah kuota referensi untuk objek Cold Archive dan Deep Cold Archive dilampaui. Permintaan tersebut akan dimasukkan ke dalam antrian, dan waktu penyelesaian mungkin lebih lama dari yang diharapkan sesuai dengan prioritas yang dipilih.

Durasi Status Dipulihkan

Tabel berikut menunjukkan durasi status dipulihkan untuk objek dalam kelas penyimpanan yang berbeda.

Kelas penyimpanan	Deskripsi
Archive	Bilangan bulat dari 1 hingga 7. Unit: hari.
Cold Archive	Bilangan bulat dari 1 hingga 365. Unit: hari.
Deep Cold Archive	Bilangan bulat dari 1 hingga 365. Unit: hari.

Sintaks Perintah

ossutil api restore-object --bucket value --key value [flags]

Parameter	Tipe	Deskripsi
--bucket	string	Nama bucket.
--key	string	Jalur lengkap objek.
--restore-request	string	Informasi permintaan pemulihan.
--version-id	string	ID versi objek yang ingin Anda pulihkan.

Catatan

Perintah restore-object sesuai dengan Operasi API RestoreObject. Untuk informasi lebih lanjut tentang parameter operasi API ini, lihat RestoreObject.

--restore-request

Opsi konfigurasi --restore-request mendukung sintaks XML dan JSON. Jika nilai opsi mencakup awalan file://, konfigurasi akan dibaca dari file lokal yang ditentukan.

Sintaks XML:

<RestoreRequest>
  <Days>integer</Days>
  <JobParameters>
    <Tier>string</Tier>
  </JobParameters>
</RestoreRequest>

Sintaks JSON:

{
  "Days": integer,
  "JobParameters": {
    "Tier": "string"
  }
}

Catatan

Untuk informasi lebih lanjut tentang opsi baris perintah global yang didukung, lihat Opsi baris perintah global yang didukung.

Contoh

Memulihkan objek Archive

Contoh berikut menunjukkan cara memulihkan objek Archive bernama exampleobject dari bucket examplebucket.

Gunakan file konfigurasi XML. Berikut adalah isi dari restore-request.xml:

<?xml version="1.0" encoding="UTF-8"?>
<RestoreRequest>
  <Days>2</Days>
</RestoreRequest>

Contoh perintah:

ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.xml

Gunakan file konfigurasi JSON. Berikut adalah isi dari restore-request.json:

{
  "Days": "2"
}

Contoh perintah:

ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.json

Gunakan parameter konfigurasi JSON. Contoh perintah:

ossutil api restore-object  --bucket examplebucket --key exampleobject --restore-request "{\"Days\":\"2\"}"

Memulihkan objek Cold Archive atau Deep Cold Archive

Contoh berikut menunjukkan cara memulihkan objek Cold Archive bernama exampleobject dari bucket examplebucket.

Gunakan file konfigurasi XML. Berikut adalah isi dari restore-request.xml:

<?xml version="1.0" encoding="UTF-8"?>
<RestoreRequest>
  <Days>2</Days>
  <JobParameters>
    <Tier>Standard</Tier>
  </JobParameters>
</RestoreRequest>

Contoh perintah:

ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.xml

Gunakan file konfigurasi JSON. Berikut adalah isi dari restore-request.json:

{
  "Days": "2",
  "JobParameters": {
    "Tier": "Standard"
  }
}

Contoh perintah:

ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.json

Gunakan parameter konfigurasi JSON. Contoh perintah:

ossutil api restore-object  --bucket examplebucket --key exampleobject --restore-request "{\"Days\":\"2\",\"JobParameters\":{\"Tier\":\"Standard\"}}"

Operasi API Terkait

Perintah restore-object sesuai dengan Operasi API RestoreObject. Untuk informasi lebih lanjut, lihat RestoreObject.