Object Storage Service:RestoreObject

Önkoşullar

• Nesne Arşiv, Soğuk Arşiv veya Derin Soğuk Arşiv depolama sınıfını kullanır. Daha fazla bilgi için bkz. Depolama sınıfları.

• oss:RestoreObject iznine sahipsiniz. RAM kullanıcısına özel ilke ekleme.

Notlar

• RestoreObject işlemi yalnızca Arşiv, Soğuk Arşiv ve Derin Soğuk Arşiv nesneleri için geçerlidir. Standart veya Seyrek Erişim (IA) nesneleri için uygulanamaz.

• Nesne verilerini okumayan bir istek göndermeden önce Arşiv, Soğuk Arşiv veya Derin Soğuk Arşiv nesnesini geri yüklemeniz gerekmez. Bu tür isteklere DeleteObject, DeleteMultipleObjects, GetObjectMeta veya HeadObject örnek verilebilir. Geri yükleme gerektirmeyen bir işlem için nesneyi geri yüklerseniz gereksiz ek ücret ödersiniz.

• Bir nesne için RestoreObject işlemini ilk kez çağırdığınızda 202 Accepted yanıtı alırsınız. Nesne zaten geri yüklenmiş durumdaysa sonraki çağrılar 200 OK yanıtı döndürür.

• Bir nesne hâlâ geri yükleniyorsa başka bir geri yükleme isteği yalnızca geri yükleme önceliğini artırmak için gönderilebilir. Bunun dışındaki herhangi bir istek 409 hatası döndürür.

• Sürüm oluşturmanın etkinleştirildiği paketlerde bir nesnenin farklı sürümleri farklı depolama sınıflarına sahip olabilir. Varsayılan olarak RestoreObject işleminin çağrılması nesnenin mevcut sürümünü geri yükler. versionId belirterek belirli bir sürümü geri yükleyebilirsiniz.

Geri yükleme süreci

Farklı depolama sınıflarındaki nesneler için geri yükleme süreci aynıdır. Süreç aşağıdaki gibidir.

1. Başlangıçta nesne dondurulmuş durumdadır.

2. Geri yükleme isteği gönderdikten sonra nesne geri yükleniyor durumuna geçer.

3. Sunucu tarafındaki görev tamamlandığında nesne geri yüklenmiş duruma geçer. Bu aşamadan sonra nesneyi okuyabilirsiniz.

4. Nesne geri yüklenmiş durumdayken başka bir geri yükleme isteği gönderirseniz geri yüklenmiş durumun süresi uzatılır. Toplam uzatma süresi depolama sınıfı için izin verilen maksimum süreyi aşamaz.

5. Geri yüklenmiş durum sona erdiğinde nesne tekrar dondurulmuş duruma döner ve orijinal depolama sınıfı değişmez.

Geri yükleme süresi

Farklı depolama sınıflarındaki nesnelerin geri yüklenmesi için gereken süreler aşağıdaki tabloda listelenmiştir. Gerçek geri yükleme süreleri değişiklik gösterebilir.

Geri yüklenmiş durumun süresi

Nesnelerin geri yüklenmiş durumda kalabileceği süre depolama sınıfına göre değişir.

Faturalandırma

• Arşiv, Soğuk Arşiv ve Derin Soğuk Arşiv nesnelerini geri yüklediğinizde veri alma ücreti ödersiniz. Daha fazla bilgi için bkz. Veri işleme ücretleri.

• Arşiv nesnelerini geri yüklediğinizde Put isteği ücreti ödersiniz. Daha fazla bilgi için bkz. İstek ücretleri.

• Soğuk Arşiv ve Derin Soğuk Arşiv nesnelerini geri yüklediğinizde veri alma isteği ücreti ödersiniz. Daha fazla bilgi için bkz. İstek ücretleri.

• Arşiv, Soğuk Arşiv ve Derin Soğuk Arşiv nesneleri hem geri yükleme sırasında hem de geri yüklendikten sonra ilgili depolama sınıflarına göre depolama ücretine tabi olur. Daha fazla bilgi için bkz. Depolama ücretleri.

• Bir Soğuk Arşiv veya Derin Soğuk Arşiv nesnesini geri yüklediğinizde erişime olanak tanımak için nesnenin Standart depolama sınıfında bir çoğaltması oluşturulur. Nesne geri yüklenmiş durumdayken bu çoğaltmanın geçici depolaması için Standart depolama sınıfı oranında ücretlendirilirsiniz. Daha fazla bilgi için bkz. Geçici depolama ücretleri.

• Arşiv nesneleri en fazla 7 gün boyunca geri yüklenmiş durumda kalabilir. Soğuk Arşiv ve Derin Soğuk Arşiv nesneleri en fazla 365 gün boyunca geri yüklenmiş durumda kalabilir. Bu süre zarfında ek veri alma ücreti oluşmaz.

• Geri yüklenmiş durum sona erdiğinde nesne tekrar dondurulmuş duruma döner. Nesneyi tekrar geri yüklerseniz veri alma ücreti ödersiniz.

İstek sözdizimi

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

İstek üstbilgileri

RestoreObject yalnızca ortak istek üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak istek üstbilgileri.

İstek parametreleri

Yanıt üstbilgileri

RestoreObject yanıtları ortak yanıt üstbilgilerini içerir. Daha fazla bilgi için bkz. Ortak yanıt üstbilgileri.

Örnekler

• Dondurulmuş bir Arşiv nesnesini geri yükleme (ilk istek)

  Örnek istek

  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

  Örnek başarılı yanıt

  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

• Geri yüklenmekte olan bir Arşiv nesnesini geri yükleme

  Örnek istek

  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

  Örnek başarılı yanıt

  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>

• Zaten geri yüklenmiş durumda olan bir Arşiv nesnesini geri yükleme

  Örnek istek

  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>

  Örnek başarılı yanıt

  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

• Zaten geri yüklenmiş durumda olan bir Soğuk Arşiv veya Derin Soğuk Arşiv nesnesini geri yükleme

  Örnek istek

  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>

  Örnek başarılı yanıt

  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

• Belirli bir nesne sürümünü geri yükleme

  Örnek istek

  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

  Örnek başarılı yanıt

  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 SDK'ları

RestoreObject işlemini şu diller için OSS SDK'ları ile çağırın:

• Java

• Python V2

• PHP V2

• Go V2

• C

• C++

• .NET

• Android

• iOS

• Node.js

• Harmony

• Browser.js

ossutil

RestoreObject işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. restore-object.

Hata kodları

Referanslar

• Geri yükleme için gereken süre ve bir nesnenin geri yüklenmiş durumda kaldığı gün sayısı hakkında daha fazla bilgi için bkz. Nesneleri geri yükleme.

• Bir nesneyi geri yüklemek için ossutil'in nasıl kullanılacağı hakkında daha fazla bilgi için bkz. Dosyaları geri yükleme.

• Bir nesneyi geri yüklenmiş durumda kalıcı olarak tutma hakkında daha fazla bilgi için bkz. Bir OSS nesnesi nasıl kalıcı olarak geri yüklenmiş durumda tutulur?