Object Storage Service：RestoreObject

Prasyarat

• Kelas penyimpanan objek yang ingin dikembalikan adalah Arsip, Penyimpanan Arsip Dingin, atau Deep Cold Archive. Untuk informasi lebih lanjut, lihat Kelas penyimpanan.

• Anda memiliki izin oss:RestoreObject. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.

Catatan

• Operasi RestoreObject hanya berlaku untuk objek Arsip, Penyimpanan Arsip Dingin, dan Deep Cold Archive. Operasi ini tidak berlaku untuk objek Standar atau Infrequent Access (IA).

• Anda dapat melakukan operasi akses non-data pada objek Arsip, Penyimpanan Arsip Dingin, dan Deep Cold Archive tanpa pengembalian. Operasi tersebut meliputi DeleteObject, DeleteMultipleObjects, GetObjectMeta, dan HeadObject. Biaya tambahan akan dikenakan jika objek dikembalikan.

• Saat memanggil operasi RestoreObject pertama kali pada objek Arsip, Penyimpanan Arsip Dingin, atau Deep Cold Archive, kode status HTTP 202 dikembalikan. Saat memanggil RestoreObject pada objek yang sudah dikembalikan, respons 200 OK dikembalikan.

• Untuk objek yang sedang dikembalikan, Anda hanya dapat memanggil operasi RestoreObject lagi untuk meningkatkan prioritas pengembalian. Jika tidak, kode kesalahan 409 dikembalikan.

• Dalam bucket dengan versi aktif, kelas penyimpanan versi berbeda dari sebuah objek bisa bervariasi. Secara default, saat Anda memanggil operasi RestoreObject pada sebuah objek, versi terkini dari objek tersebut dikembalikan. Anda dapat menentukan ID versi dalam permintaan untuk mengembalikan versi tertentu dari objek.

Proses

Berikut ini adalah proses pengembalian yang berlaku untuk objek Arsip, Penyimpanan Arsip Dingin, dan Deep Cold Archive:

1. Awalnya, objek berada dalam keadaan beku.

2. Setelah Anda mengirimkan permintaan untuk mengembalikan objek, objek masuk ke keadaan pengembalian.

3. Setelah server OSS menyelesaikan tugas pengembalian, objek masuk ke keadaan telah dikembalikan dan dapat diakses.

4. Anda dapat mengajukan permintaan pengembalian lain pada objek dalam keadaan telah dikembalikan untuk memperpanjang durasi keadaan tersebut. Durasi keadaan telah dikembalikan tidak boleh melebihi durasi maksimum yang didukung untuk kelas penyimpanan yang sesuai.

5. Setelah durasi keadaan telah dikembalikan berakhir, objek kembali ke keadaan beku tanpa mengubah kelas penyimpanannya.

Waktu pengembalian

Tabel berikut menggambarkan waktu yang diperlukan untuk mengembalikan objek dalam kelas penyimpanan yang berbeda. Waktu pengembalian yang diberikan adalah referensi. Waktu pengembalian sebenarnya mungkin bervariasi berdasarkan skenario spesifik.

Durasi keadaan telah dikembalikan

Tabel berikut menggambarkan durasi keadaan telah dikembalikan untuk objek dalam kelas penyimpanan yang berbeda.

Tagihan

• Anda dikenakan biaya pengambilan data berdasarkan ukuran objek Arsip, Penyimpanan Arsip Dingin, atau Deep Cold Archive yang dikembalikan. Untuk informasi lebih lanjut, lihat Biaya pemrosesan data.

• Anda dikenakan biaya panggilan operasi API berdasarkan jumlah permintaan PUT saat Anda mengembalikan objek Arsip. Untuk informasi lebih lanjut, lihat Biaya permintaan.

• Anda dikenakan biaya permintaan pengambilan data saat Anda mengembalikan objek Penyimpanan Arsip Dingin atau Deep Cold Archive. Untuk informasi lebih lanjut, lihat Biaya permintaan.

• Anda dikenakan biaya penyimpanan berdasarkan aturan penagihan untuk objek Arsip, Penyimpanan Arsip Dingin, dan Deep Cold Archive selama dan setelah pengembalian. Untuk informasi lebih lanjut, lihat Biaya penyimpanan.

• Saat Anda mengembalikan objek Penyimpanan Arsip Dingin atau Deep Cold Archive, replika Standar dari objek tersebut dibuat untuk akses sementara. Anda dikenakan biaya untuk penyimpanan sementara replika tersebut berdasarkan kelas penyimpanan Standar sampai objek Penyimpanan Arsip Dingin atau Deep Cold Archive kembali ke keadaan beku. Untuk informasi lebih lanjut, lihat Biaya penyimpanan sementara.

• Objek Arsip dapat tetap berada dalam keadaan telah dikembalikan hingga tujuh hari. Objek Penyimpanan Arsip Dingin atau Deep Cold Archive dapat tetap berada dalam keadaan telah dikembalikan hingga 365 hari. Anda tidak dikenakan biaya pengambilan data saat objek berada dalam keadaan telah dikembalikan.

• Setelah durasi keadaan telah dikembalikan berakhir, objek kembali ke keadaan beku. Biaya pengambilan data akan dibebankan jika Anda melakukan operasi pengembalian pada objek tersebut lagi.

Sintaksis permintaan

POST /ObjectName?restore HTTP/1.1
Host: archive-bucket.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Header permintaan

Header permintaan dalam permintaan RestoreObject hanya mencakup header permintaan umum. Untuk informasi lebih lanjut, lihat Header permintaan umum.

Parameter permintaan

Header respons

Respons terhadap permintaan RestoreObject berisi header respons umum. Untuk informasi lebih lanjut, lihat Header respons umum.

Contoh

• Menginisiasi permintaan RestoreObject untuk objek Arsip dalam keadaan beku untuk pertama kali

  Permintaan contoh

  POST /oss.jpg?restore HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Sat, 15 Apr 2017 07:45:28 GMT
  Authorization: OSS qn6q**************:77Dv****************

  Respons sukses contoh

  HTTP/1.1 202 Accepted
  Date: Sat, 15 Apr 2017 07:45:28 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-request-id: 5374A2880232A65C23002D74

• Menginisiasi permintaan RestoreObject untuk objek Arsip dalam keadaan pengembalian

  Permintaan contoh

  POST /oss.jpg?restore HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Sat, 15 Apr 2017 07:45:29 GMT
  Authorization: OSS qn6q**************:77Dv****************

  Respons sukses contoh

  HTTP/1.1 409 Conflict
  Date: Sat, 15 Apr 2017 07:45:29 GMT
  Content-Length: 556
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-request-id: 5374A2880232A65C23002D74
  <?xml version="1.0" encoding="UTF-8"?>
  <Error>
    <Code>RestoreAlreadyInProgress</Code>
    <Message>The restore operation is in progress.</Message>
    <RequestId>58EAF141461FB42C2B000008</RequestId>
    <HostId>10.101.XX.XX</HostId>
  </Error>

• Menginisiasi permintaan RestoreObject untuk objek Arsip dalam keadaan telah dikembalikan

  Permintaan contoh

  POST /oss.jpg?restore HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Sat, 15 Apr 2017 07:45:29 GMT
  Authorization: OSS qn6q**************:77Dv****************
  <RestoreRequest>
    <Days>2</Days>
  </RestoreRequest>

  Respons sukses contoh

  HTTP/1.1 200 Ok
  Date: Sat, 15 Apr 2017 07:45:30 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-request-id: 5374A2880232A65C23002D74

• Menginisiasi permintaan RestoreObject untuk objek Penyimpanan Arsip Dingin atau Deep Cold Archive dalam keadaan telah dikembalikan

  Permintaan contoh

  POST /coldarchiveobject?restore HTTP/1.1
  Host: cold-archive-bucket.oss-cn-hangzhou.aliyuncs.com
  User-Agent: aliyun-sdk-go/v2.1.0 (Darwin/17.5.0/x86_64;go1.11.8)/ossutil-v1.6.12
  Content-Length: 99
  Authorization: OSS qn6q**************:77Dv****************
  Content-Type: text/plain; charset=utf-8
  Date: Tue, 21 Apr 2020 11:09:19 GMT
  Accept-Encoding: gzip
  <RestoreRequest>
    <Days>2</Days>
    <JobParameters>
      <Tier>Standard</Tier>
    </JobParameters>
  </RestoreRequest>

  Respons sukses contoh

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Date: Tue, 21 Apr 2020 11:09:19 GMT
  Content-Length: 0
  Connection: keep-alive
  x-oss-request-id: 5E9ED45F093E2F3930318EA0
  x-oss-object-restore-priority: Standard
  x-oss-server-time: 10

• Tentukan ID versi saat Anda memanggil operasi RestoreObject untuk mengembalikan objek

  Permintaan contoh

  POST /oss.jpg?restore&versionId=CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh**** HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 06:50:48 GMT
  Authorization: OSS qn6q**************:77Dv****************

  Respons sukses contoh

  HTTP/1.1 202 Accepted
  Date: Tue, 09 Apr 2019 06:50:48 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-version-id: CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh****
  x-oss-request-id: 5CAC40C8B7AEADE017000653

SDK

Anda dapat menggunakan SDK OSS untuk bahasa pemrograman berikut untuk memanggil operasi RestoreObject:

• Java

• Python

• PHP

• Go V2

• C

• C++

• .NET

• Android

• iOS

• Node.js

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi RestoreObject, lihat restore-object.

Kode kesalahan

Referensi

• Untuk informasi lebih lanjut tentang jumlah waktu yang diperlukan untuk pengembalian dan jumlah hari di mana objek tetap berada dalam keadaan telah dikembalikan, lihat Mengembalikan objek.

• Untuk informasi lebih lanjut tentang cara menggunakan ossutil untuk mengembalikan sebuah objek, lihat restore.

• Untuk informasi lebih lanjut tentang cara membuat objek tetap berada dalam keadaan telah dikembalikan secara permanen, lihat Apa yang harus saya lakukan agar objek tetap berada dalam keadaan telah dikembalikan secara permanen?