:restore-object

Catatan penggunaan

• Secara default, Akun Alibaba Cloud memiliki izin untuk memulihkan objek. Pemulihan objek sebagai pengguna RAM atau dengan menggunakan Security Token Service (STS) memerlukan izin oss:RestoreObject. Untuk informasi selengkapnya, lihat Grant a custom policy.

• Perintah restore-object hanya berlaku untuk objek Archive atau Cold Archive, dan tidak berlaku untuk objek Standard atau Infrequent Access (IA).

• Untuk membaca objek Archive atau Cold Archive, Anda harus memulihkannya terlebih dahulu. Pemulihan objek Archive memerlukan waktu beberapa menit, sedangkan pemulihan objek Cold Archive memerlukan waktu beberapa jam.

• Status dipulihkan (restored state) objek Archive berlangsung maksimal 7 hari (nilai parameter Days berkisar antara 1 hingga 7). Setelah masa tersebut berakhir, objek secara otomatis kembali ke status beku (frozen state). Jika Anda berencana melakukan migrasi data (misalnya lintas akun atau migrasi skala besar) setelah memulihkan objek dan proses tersebut diperkirakan memakan waktu lebih dari 7 hari, gunakan CopyObject untuk mengonversi objek Archive ke kelas penyimpanan Standard dalam periode validitas pemulihan sebelum memulai migrasi. Langkah ini mencegah kegagalan migrasi akibat objek kembali ke status beku setelah masa restored state berakhir.

Penagihan

Biaya penyimpanan, biaya pengambilan data, dan biaya pemanggilan Operasi API dikenakan saat Anda memulihkan objek. Selain itu, biaya penyimpanan sementara juga dikenakan saat Anda memulihkan objek Cold Archive dan Deep Cold Archive.

• Biaya penyimpanan: Anda dikenai biaya penyimpanan berdasarkan aturan penagihan untuk objek Archive, Cold Archive, dan Deep Cold Archive selama dan setelah pemulihan. Untuk informasi selengkapnya, lihat Storage fees.

• Anda dikenai biaya pengambilan data berdasarkan ukuran objek Archive, Cold Archive, atau Deep Cold Archive yang dipulihkan. Untuk informasi selengkapnya, lihat Data processing fees.

• Biaya pemanggilan Operasi API:

  • Anda dikenai biaya pemanggilan Operasi API berdasarkan jumlah permintaan PUT saat memulihkan objek Archive. Untuk informasi selengkapnya, lihat Request fees.

  • Anda dikenai biaya permintaan pengambilan data saat memulihkan objek Cold Archive atau Deep Cold Archive. Untuk informasi selengkapnya, lihat Request fees.

• Biaya penyimpanan sementara: Saat Anda memulihkan objek Cold Archive atau Deep Cold Archive, replika objek tersebut dibuat untuk akses sementara. Anda dikenai biaya penyimpanan sementara untuk replika tersebut berdasarkan kelas penyimpanan Standard hingga objek Cold Archive atau Deep Cold Archive kembali ke status beku. Untuk informasi selengkapnya, lihat Temporary storage fees.

Proses pemulihan

Proses pemulihan sama untuk objek dari kelas penyimpanan yang berbeda, yaitu sebagai berikut.

1. Pada awalnya, objek berada dalam status beku (frozen state).

2. Setelah Anda mengirim permintaan pemulihan, objek memasuki status sedang dipulihkan (restoring state).

3. Setelah tugas di sisi server selesai, objek memasuki status dipulihkan (restored state) dan dapat dibaca.

4. Jika Anda mengirim permintaan pemulihan lain saat objek berada dalam status dipulihkan, durasi status tersebut akan diperpanjang. Total durasi perpanjangan tidak boleh melebihi durasi maksimum yang diizinkan untuk kelas penyimpanan tersebut.

5. Setelah status dipulihkan berakhir, objek kembali ke status beku, dan kelas penyimpanan aslinya tetap tidak berubah.

Waktu pemulihan

Waktu yang diperlukan untuk memulihkan objek dari kelas penyimpanan yang berbeda tercantum dalam tabel berikut. Waktu pemulihan aktual dapat bervariasi.

Kuota pemulihan

• Untuk satu Akun Alibaba Cloud di satu Wilayah, kuota pemulihan referensi untuk objek Cold Archive adalah rata-rata 500 objek per detik, dan total kuota gabungan dari ketiga prioritas pemulihan adalah 100 TB hingga 120 TB per hari. Jika bisnis Anda memerlukan kuota pemulihan yang lebih tinggi, hubungi Technical Support.

• Untuk satu Akun Alibaba Cloud di satu Wilayah, kuota pemulihan referensi untuk objek Deep Cold Archive adalah rata-rata 100 objek per detik, dan total kuota gabungan dari dua prioritas pemulihan adalah 10 TB hingga 15 TB per hari. Jika bisnis Anda memerlukan kuota pemulihan yang lebih tinggi, hubungi Technical Support.

Setelah kuota pemulihan referensi untuk objek Cold Archive atau Deep Cold Archive terlampaui, Anda tetap dapat mengirim permintaan pemulihan. Permintaan tersebut akan masuk antrian, dan pemulihan mungkin memerlukan waktu lebih lama daripada waktu yang terkait dengan prioritas pemulihan yang ditentukan.

Durasi status dipulihkan

Durasi objek dapat tetap dalam status dipulihkan bervariasi berdasarkan kelas penyimpanannya.

Sintaksis perintah

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

--restore-request

Opsi konfigurasi --restore-request mendukung format XML dan JSON. Jika nilai opsi tersebut diawali dengan file://, parameter konfigurasi dibaca dari file yang ditentukan.

• Format XML:

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

• Format JSON:

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

Contoh

Operasi API terkait

Perintah restore-object bersesuaian dengan operasi RestoreObject. Untuk informasi selengkapnya, lihat RestoreObject.