Object Storage Service:RestoreObject

Prasyarat

• Objek menggunakan kelas penyimpanan Arsip, Penyimpanan Arsip Dingin, atau Deep Cold Archive. Untuk informasi selengkapnya, lihat Storage classes.

• Anda memiliki izin oss:RestoreObject. Attach a custom policy to a RAM user.

Catatan

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

• Saat pertama kali memanggil operasi RestoreObject untuk suatu objek, respons 202 Accepted akan dikembalikan. Jika objek sudah berada dalam keadaan dipulihkan, panggilan berikutnya akan mengembalikan respons 200 OK.

• Anda tidak dapat memanggil operasi RestoreObject pada objek yang sedang dalam proses pemulihan. Melakukannya akan menghasilkan error 409 Conflict. Tunggu hingga pemulihan selesai sebelum memanggil operasi tersebut lagi.

• Untuk bucket dengan Pengendalian versi aktif, versi berbeda dari suatu objek dapat memiliki kelas penyimpanan yang berbeda. Secara default, operasi RestoreObject akan memulihkan versi terkini dari objek tersebut. Anda dapat memulihkan versi tertentu dengan menentukan versionId-nya.

Proses pemulihan

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

1. Awalnya, objek berada dalam status beku.

2. Setelah Anda mengirim permintaan pemulihan, objek memasuki status restoring.

3. Setelah tugas sisi server selesai, objek memasuki keadaan dipulihkan dan dapat dibaca.

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

5. Setelah masa keadaan dipulihkan berakhir, objek kembali ke status beku.

Waktu pemulihan

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

^①Untuk satu Akun Alibaba Cloud di satu Wilayah, laju pengambilan data perkiraan untuk objek Cold Archive adalah rata-rata 500 objek per detik. Total jumlah pengambilan di semua tiga prioritas pemulihan adalah 100 TB hingga 120 TB per hari. Jika bisnis Anda memerlukan laju pengambilan yang lebih tinggi, hubungi Technical Support.

^②Untuk satu Akun Alibaba Cloud di satu Wilayah, laju pengambilan data perkiraan untuk objek Deep Cold Archive adalah rata-rata 100 objek per detik. Total jumlah pengambilan di kedua prioritas pemulihan adalah 10 TB hingga 15 TB per hari. Jika bisnis Anda memerlukan laju pengambilan yang lebih tinggi, hubungi Technical Support.

Durasi keadaan dipulihkan

Durasi objek dapat tetap berada dalam keadaan dipulihkan bervariasi tergantung kelas penyimpanannya.

Penagihan

• Biaya pengambilan data dikenakan saat Anda memulihkan objek Arsip, Penyimpanan Arsip Dingin, dan Deep Cold Archive. Untuk informasi selengkapnya, lihat Data processing fees.

• Objek Arsip dapat tetap dalam keadaan dipulihkan hingga 7 hari. Objek Penyimpanan Arsip Dingin dan Deep Cold Archive dapat tetap dalam keadaan dipulihkan hingga 365 hari. Tidak ada biaya pengambilan data tambahan yang dikenakan selama periode ini.

• Setelah masa keadaan dipulihkan berakhir, objek kembali ke status beku. Jika Anda memulihkan objek tersebut lagi, biaya pengambilan data akan dikenakan.

• Saat Anda memulihkan objek Penyimpanan Arsip Dingin atau Deep Cold Archive, replika objek tersebut dibuat dalam kelas penyimpanan Standard agar dapat diakses. Selama objek berada dalam keadaan dipulihkan, Anda dikenai biaya penyimpanan sementara replika ini sesuai tarif kelas penyimpanan Standard. Untuk informasi selengkapnya, lihat Temporary storage fees.

Sintaksis permintaan

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

Header permintaan

RestoreObject hanya menggunakan header permintaan umum. Untuk informasi selengkapnya, lihat Common request headers.

Parameter permintaan

Header respons

Respons RestoreObject mencakup header respons umum. Untuk informasi selengkapnya, lihat Common response headers.

Contoh

• Memulihkan objek Arsip yang beku (permintaan pertama)

  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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  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

• Memulihkan objek Arsip yang sedang dalam proses pemulihan

  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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  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>

• Memulihkan objek Arsip yang sudah dalam keadaan dipulihkan

  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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  <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

• Memulihkan objek Cold Archive atau Deep Cold Archive yang sudah dalam keadaan dipulihkan

  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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  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

• Memulihkan versi objek tertentu

  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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  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

OSS SDKs

Panggil RestoreObject dengan OSS SDK untuk bahasa-bahasa berikut:

• Java

• Python V2

• PHP V2

• Go V2

• C

• C++

• .NET

• Android

• iOS

• Node.js

• Harmony

• Browser.js

ossutil

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

Kode error

Referensi

• Untuk informasi selengkapnya tentang waktu yang diperlukan untuk pemulihan dan jumlah hari objek tetap dalam keadaan dipulihkan, lihat Restore objects.

• Untuk informasi selengkapnya tentang cara menggunakan ossutil untuk memulihkan objek, lihat Restore Files.

• Untuk informasi selengkapnya tentang cara menyimpan objek secara permanen dalam keadaan dipulihkan, lihat How to keep an OSS object permanently restored?.