Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:restore-object

Son Güncelleme:Oct 01, 2026

restore-object komutu, Arşiv veya Soğuk Arşiv nesnelerini geri yüklemek için kullanılır.

Kullanım notları

  • Varsayılan olarak Alibaba Cloud hesabı nesneleri geri yükleme iznine sahiptir. Bir RAM kullanıcısı veya Security Token Service (STS) kullanarak nesneleri geri yüklemek için oss:RestoreObject izni gerekir. Daha fazla bilgi için bkz. Özel ilke atama.

  • restore-object komutu yalnızca Arşiv veya Soğuk Arşiv nesnelerine uygulanır. Bu komut Standart veya Seyrek Erişim (IA) nesnelerine uygulanmaz.

  • Bir Arşiv veya Soğuk Arşiv nesnesini okumak için önceden nesneyi geri yüklemeniz gerekir. Bir Arşiv nesnesinin geri yüklenmesi birkaç dakika, Soğuk Arşiv nesnesinin geri yüklenmesi ise birkaç saat sürer.

  • Bir Arşiv nesnesinin geri yüklenmiş durumu en fazla 7 gün sürer (Days parametresi değeri 1 ile 7 arasında olabilir). Geri yükleme süresi dolduğunda nesne otomatik olarak dondurulmuş duruma döner. Nesneyi geri yükledikten sonra veri geçişi (örneğin hesaplar arası veya büyük ölçekli geçiş) planlıyorsanız ve bu geçiş 7 günden uzun sürebiliyorsa, geçişi başlatmadan önce geri yükleme geçerlilik süresi içinde CopyObject kullanarak Arşiv nesnesini Standart depolama sınıfına dönüştürün. Bu, geri yüklenmiş durumun sona ermesinden sonra nesnenin dondurulmuş duruma dönmesi kaynaklı geçiş hatalarını önler.

Faturalama

Nesneleri geri yüklerken depolama ücretleri, veri alma ücretleri ve API çağrı ücretleri oluşur. Ayrıca, Soğuk Arşiv ve Derin Soğuk Arşiv nesnelerini geri yüklerken geçici depolama ücretleri tahakkuk eder.

  • Depolama ücretleri: Geri yükleme sırasında ve sonrasında Arşiv, Soğuk Arşiv ve Derin Soğuk Arşiv nesneleri için faturalama kurallarına göre depolama ücreti ödersiniz. Daha fazla bilgi için bkz. Depolama ücretleri.

  • Geri yüklenen Arşiv, Soğuk Arşiv veya Derin Soğuk Arşiv nesnelerinin boyutuna göre veri alma ücreti ödersiniz. Daha fazla bilgi için bkz. Veri işleme ücretleri.

  • API çağrı ücretleri:

    • Arşiv nesnelerini geri yüklerken PUT isteği sayısına göre API çağrı ücreti ödersiniz. Daha fazla bilgi için bkz. İstek ücretleri.

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

  • Geçici depolama ücretleri: Soğuk Arşiv veya Derin Soğuk Arşiv nesnesini geri yüklediğinizde, geçici erişim için nesnenin bir kopyası oluşturulur. Soğuk Arşiv veya Derin Soğuk Arşiv nesnesi dondurulmuş duruma dönene kadar, bu kopyanın geçici depolanması için Standart depolama sınıfı ücretlendirilir. Daha fazla bilgi için bkz. Geçici depolama ücretleri.

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. Artık 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 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.

Nesne depolama sınıfı

Açıklama

Arşiv

Genellikle 1 dakika.

Soğuk Arşiv

  • Hızlandırılmış: Geri yükleme genellikle 1 saat içinde tamamlanır.

  • Standart: Geri yükleme genellikle 2 ila 5 saat içinde tamamlanır.

  • Toplu: Geri yükleme genellikle 5 ila 12 saat içinde tamamlanır.

Derin Soğuk Arşiv

  • Hızlandırılmış: Geri yükleme genellikle 12 saat içinde tamamlanır.

  • Standart: Geri yükleme genellikle 48 saat içinde tamamlanır.

Geri yükleme kotası

  • Tek bir bölgede tek bir Alibaba Cloud hesabı için Soğuk Arşiv nesnelerinin referans geri yükleme kotası ortalama saniyede 500 nesnedir ve üç geri yükleme önceliği genelindeki toplam kota günde 100 TB ile 120 TB arasındadır. İşletmeniz daha yüksek bir geri yükleme kotası gerektiriyorsa Teknik Destek ile iletişime geçin.

  • Tek bir bölgede tek bir Alibaba Cloud hesabı için Derin Soğuk Arşiv nesnelerinin referans geri yükleme kotası ortalama saniyede 100 nesnedir ve iki geri yükleme önceliği genelindeki toplam kota günde 10 TB ile 15 TB arasındadır. İşletmeniz daha yüksek bir geri yükleme kotası gerektiriyorsa Teknik Destek ile iletişime geçin.

Soğuk Arşiv veya Derin Soğuk Arşiv nesneleri için referans geri yükleme kotası aşıldığında geri yükleme istekleri göndermeye devam edebilirsiniz. İstekler sıraya alınır ve geri yükleme, belirtilen geri yükleme önceliğiyle ilişkili süreden daha uzun sürebilir.

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.


Nesne depolama sınıfı


Açıklama


Arşiv


1 ila 7 gün.


Soğuk Arşiv


1 ila 365 gün.


Derin Soğuk Arşiv


1 ila 365 gün.

Komut sözdizimi

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


Parametre


Tür


Açıklama


--bucket


dize


Paket adı.


--key


dize


Nesnenin tam yolu.


--restore-request


dize


Geri yükleme isteği bilgileri.


--version-id


dize


Geri yüklemek istediğiniz nesnenin sürüm kimliği.

Not

restore-object komutu RestoreObject işlemine karşılık gelir. RestoreObject işlemindeki parametreler hakkında daha fazla bilgi için bkz. RestoreObject.

--restore-request

--restore-request yapılandırma seçeneği hem XML hem de JSON formatlarını destekler. Seçeneğin değeri 'file://' ön ekini içeriyorsa, yapılandırma parametreleri belirtilen dosyadan okunur.

  • XML formatı:

    <RestoreRequest>
      <Days>integer</Days>
      <JobParameters>
        <Tier>string</Tier>
      </JobParameters>
    </RestoreRequest>
  • JSON formatı:

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

Desteklenen genel komut satırı seçenekleri hakkında daha fazla bilgi için bkz. Komut satırı seçenekleri.

Örnekler

Arşiv nesnesini geri yükleme

examplebucket paketinde exampleobject adlı bir Arşiv nesnesini geri yükleyin.

  • restore-request.xml adında bir yapılandırma dosyası oluşturun ve aşağıdaki kodu ekleyin:

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

    Örnek komut:

    ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.xml
  • restore-request.json adında bir yapılandırma dosyası oluşturun ve aşağıdaki kodu ekleyin:

    {
      "Days": "2"
    }

    Örnek komut:

    ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.json
  • Aşağıdaki komutta parametreleri JSON formatında yapılandırın:

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

Soğuk Arşiv ve Derin Soğuk Arşiv nesnelerini geri yükleme

examplebucket paketinde exampleobject adlı bir Soğuk Arşiv nesnesini geri yükleyin.

  • restore-request.xml adında bir yapılandırma dosyası oluşturun ve aşağıdaki kodu ekleyin:

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

    Örnek komut:

    ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.xml
  • restore-request.json adında bir yapılandırma dosyası oluşturun ve aşağıdaki kodu ekleyin:

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

    Örnek komut:

    ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.json
  • Aşağıdaki komutta parametreleri JSON formatında yapılandırın:

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

İlgili API işlemi

restore-object komutu RestoreObject işlemine karşılık gelir. Daha fazla bilgi için bkz. RestoreObject.