Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:restore

Son Güncelleme:Oct 01, 2026

Arşiv nesneleri için gerçek zamanlı erişimi etkinleştirmediyseniz bu nesnelere yalnızca geri yükleme işleminden sonra erişebilirsiniz. Soğuk Arşiv ve Derin Soğuk Arşiv nesneleri gerçek zamanlı erişimi desteklemez; bu nesnelere de yalnızca geri yüklemeden sonra erişilebilir. Genellikle bir Arşiv nesnesinin geri yüklenmesi birkaç dakika, bir Soğuk Arşiv nesnesinin geri yüklenmesi birkaç saat ve bir Derin Soğuk Arşiv nesnesinin geri yüklenmesi 12 ila 48 saat sürer. Belirtilen süreler yalnızca referans içindir; gerçek senaryoya göre değişiklik gösterebilir. Bu konuda nesneleri geri yüklemek için restore komutunun nasıl çalıştırılacağı açıklanmaktadır.

Kullanım notları

  • Tek bir nesneyi geri yüklemek için oss:RestoreObject iznine sahip olmanız gerekir. Nesneleri dizin bazında geri yüklemek için ise oss:RestoreObject ve oss:ListObjects izinlerine ihtiyacınız vardır. Daha fazla bilgi için bkz. Özel ilke atama.

  • Geri yükleme süreci ve faturalama kuralları hakkında daha fazla bilgi için bkz. Nesneleri geri yükleme.

Komut sözdizimi

ossutil restore oss://bucket/object [flags]

Parametre

Tür

Açıklama

--days

int

Nesnenin geri yüklenmiş durumda kalacağı süre. Birim: gün. Geçerli değerler: 1 ile 365 arası.

Farklı depolama sınıflarındaki birden fazla nesne üzerinde aynı anda işlem yaptığınızda ve --days parametresinin değeri belirli bir depolama sınıfı için maksimum süreyi aşarsa değer otomatik olarak o depolama sınıfının maksimum süresine ayarlanır. Örneğin Arşiv tarafından desteklenen maksimum süre 7 gün, Derin Soğuk Arşiv tarafından desteklenen maksimum süre ise 365 gündür. --days parametresini 100 olarak ayarlarsanız Arşiv nesneleri için süre otomatik olarak 7 güne, Derin Soğuk Arşiv nesneleri için süre ise 100 güne ayarlanır.

--tier

string

Geri yükleme önceliği. Arşiv nesneleri için bu parametreyi belirtmeniz gerekmez. Geri yükleme yaklaşık 1 dakika sürer.

  • Soğuk Arşiv:

    • Expedited: Nesne 1 saat içinde geri yüklenir.

    • Standard: Nesne 2~5 saat içinde geri yüklenir.

    • Bulk: Nesne 5~12 saat içinde geri yüklenir.

  • Derin Soğuk Arşiv:

    • Expedited: Nesne 12 saat içinde geri yüklenir.

    • Standard: Nesne 48 saat içinde geri yüklenir.

Farklı depolama sınıflarındaki birden fazla nesne üzerinde aynı anda işlem yaptığınızda --tier parametresinin değeri depolama sınıfının desteklediği öncelik değerini aşarsa değer otomatik olarak o depolama sınıfının en düşük önceliğine ayarlanır. Örneğin Soğuk Arşiv nesneleri Bulk seçeneğini desteklerken Derin Soğuk Arşiv nesneleri yalnızca Standard seçeneğini destekler. Bu durumda --tier parametresini Bulk olarak ayarlarsanız geri yükleme önceliği otomatik olarak Standard'a ayarlanır.

--dirs

/

Tüm alt dizinlerdeki tüm nesneleri özyinelemeli olarak listelemek yerine geçerli dizindeki nesneleri ve alt dizinleri listeler.

--encoding-type

string

Nesne adını kodlamak için kullanılan kodlama yöntemi. Geçerli değer: url.

--end-with

string

Adları alfabetik olarak --end-with parametresinin değerinden önce gelen veya bu değere eşit olan nesnelerin döndürülmesini belirtir.

--exclude

stringArray

Yollar veya nesne adları için bir dışlama kuralı belirtir.

--exclude-from

stringArray

Dışlama kurallarını bir dosyadan okur.

--files-from

stringArray

Nesne adlarını bir dosyadan okur; boş satırlar veya yorum satırları yoksayılır.

--files-from-raw

stringArray

Nesne adlarını bir dosyadan okur; boş satırlar ve yorum satırları yoksayılmaz.

--filter

stringArray

Yollar veya nesne adları için bir filtreleme kuralı belirtir.

--filter-from

stringArray

Filtreleme kurallarını bir dosyadan okur.

-f, --force

/

Onay istemeden işlemi zorla gerçekleştirir.

--include

stringArray

Yollar veya nesne adları için bir dahil etme kuralı belirtir.

--include-from

stringArray

Dahil etme kurallarını bir dosyadan okur.

--limited-num

int

Döndürülecek maksimum sonuç sayısı.

--list-objects

/

ListObjects işlemini çağırarak nesneleri listeler.

--min-age

Duration

Son değiştirilme zamanı bu seçeneğin değerinden daha yeni olan nesneleri hariç tutar. Varsayılan birim s (saniye) dir. Sayısal değerin sonuna bir zaman birimi ekleyebilirsiniz. Örneğin 1h bir saati ifade eder.

Not

--min-age 1h yalnızca bir saatten daha önce değiştirilen nesnelerin aktarılacağını belirtir.

--max-age

Duration

Son değiştirilme zamanı bu seçeneğin değerinden daha eski olan nesneleri hariç tutar. Varsayılan birim s (saniye) dir. Sayısal değerin sonuna bir zaman birimi ekleyebilirsiniz. Örneğin 1h bir saati ifade eder.

--min-mtime

Time

Son değiştirilme zamanı bu seçeneğin değerinden daha eski olan nesneleri hariç tutar. Zaman UTC formatında olmalıdır. Örnek: 2006-01-02T15:04:05.

Not

--min-mtime "2006-01-02T15:04:05" yalnızca 2 Ocak 2006, saat 15:04:05'ten sonra değiştirilen nesnelerin aktarılacağını belirtir.

--max-mtime

Time

Son değiştirilme zamanı bu seçeneğin değerinden daha yeni olan nesneleri hariç tutar. Zaman UTC formatında olmalıdır. Örnek: 2006-01-02T15:04:05.

--max-size

SizeSuffix

Aktarılabilen bir nesnenin maksimum boyutu. Varsayılan olarak boyut bayt (B) cinsindendir. Sayısal değerin sonuna 1024 tabanlı bir birim ekleyebilirsiniz: B bayt, K Kibibyte, M Mebibyte, G Gibibyte, T Tebibyte veya P Pebibyte için.

--metadata-exclude

stringArray

Nesne meta verileri için bir dışlama kuralı belirtir.

--metadata-filter

stringArray

Nesne meta verileri için filtreleme kuralı.

--metadata-filter-from

stringArray

Meta veri filtreleme kurallarını bir dosyadan okur.

--metadata-include

stringArray

Nesne meta verileri için bir dahil etme kuralı belirtir.

--min-size

SizeSuffix

Aktarılabilen bir dosya ve nesnenin minimum boyutu. Varsayılan olarak boyut bayt (B) cinsindendir. Sayısal değerin sonuna 1024 tabanlı bir birim ekleyebilirsiniz: B bayt, K Kibibyte, M Mebibyte, G Gibibyte, T Tebibyte veya P Pebibyte için.

--page-size

int

Toplu iş modunda sayfalı listeleme yapılırken sayfa başına döndürülebilecek maksimum nesne sayısı. Geçerli değerler: 1 ile 1000 arası. Varsayılan değer: 1000.

-r, --recursive

/

Komutun işlemi özyinelemeli olarak gerçekleştirmesini belirtir. Bu parametre belirtilirse komut paket içindeki tüm eşleşen nesneler üzerinde işlem yapar. Bu parametre belirtilmezse komut yalnızca belirtilen yoldaki belirtilen nesneler üzerinde işlem yapar.

--request-payer

string

İsteğin ücretini ödeyen taraf. İstek yapan tarafından ödeme özelliği etkinleştirildiyse bu parametreyi belirtin. Geçerli değer: requester.

--start-after

string

Adları alfabetik olarak --end-with parametresinin değerinden önce gelen veya bu değere eşit olan nesnelerin döndürülmesini belirtir.

--version-id

string

Nesnenin sürüm ID'si.

--list-format

string

Liste dosyasının biçimi. Geçerli değerler: plain ve inventory.

--list-manifest-from

string

Liste dosyasının biçim açıklamasını dosyadan okur. Biçim inventory ise bu parametreyi belirtmeniz gerekir.

Not

Daha fazla bilgi için bkz. Komut satırı seçenekleri.

Örnekler

Arşiv nesnelerini geri yükleme

  • Aşağıdaki örnek kod examplebucket içindeki exampleobject.txt adlı bir Arşiv nesnesinin nasıl geri yükleneceğini göstermektedir:

    ossutil restore oss://examplebucket/exampleobject.txt
  • Aşağıdaki örnek kod examplebucket içindeki exampleobject.txt adlı bir Arşiv nesnesinin nasıl geri yükleneceğini ve nesnenin geri yüklenmiş durumda kalacağı sürenin 3 olarak nasıl ayarlanacağını göstermektedir:

    ossutil restore oss://examplebucket/exampleobject.txt --days 3
  • Aşağıdaki örnek kod nesnelerin listeden nasıl geri yükleneceğini göstermektedir.

    Not

    Liste dosyasındaki her satır bir nesneyi temsil eder. İçindeki tüm nesneler oss://{bucket}/{key} OSS yolu biçimindedir.

    Aşağıdaki bölümde liste.txt dosyası örnek olarak kullanılmıştır.

    oss://examplebucket/key1
    oss://examplebucket/key2
    ossutil restore list://list.txt
  • Aşağıdaki örnek kod nesnelerin doğrudan listeden nasıl geri yükleneceğini göstermektedir. Nesnelerin durumu kontrol edilmez.

    ossutil restore list://list.txt --no-check-status 
  • Aşağıdaki örnek kod nesnelerin liste dosyasından nasıl geri yükleneceğini göstermektedir.

    Not

    Envanter yapılandırıldıktan sonra nesnelerin liste dosyasından geri yüklenmesi için gerekli olan bir csv.gz dosyası ve bir manifest.json dosyası oluşturulur.

    ossutil restore list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json
  • Aşağıdaki örnek kod nesnelerin doğrudan liste dosyasından nasıl geri yükleneceğini göstermektedir. Nesnelerin durumu kontrol edilmez.

    ossutil restore list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json --no-check-status

Soğuk Arşiv nesnelerini geri yükleme

Aşağıdaki örnek kod examplebucket içindeki exampleobject.txt adlı bir Soğuk Arşiv nesnesinin nasıl geri yükleneceğini ve nesnenin geri yüklenmiş durumda kalacağı sürenin 5 olarak nasıl ayarlanacağını göstermektedir:

ossutil restore oss://examplebucket/exampleobject.txt --tier Bulk --days 5

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

Aşağıdaki örnek kod examplebucket içindeki exampleobject.txt adlı bir Derin Soğuk Arşiv nesnesinin nasıl geri yükleneceğini ve nesnenin geri yüklenmiş durumda kalacağı sürenin 10 olarak nasıl ayarlanacağını göstermektedir:

ossutil restore oss://examplebucket/exampleobject.txt --tier Standard --days 10

Faturalama kuralları

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

  • Arşiv nesnelerini geri yüklerken yapılan PUT isteği sayısına göre API işlemi çağırma ücretleri tahakkuk eder. Daha fazla bilgi için bkz. İstek ücretleri.

  • Soğuk Arşiv veya Derin Soğuk Arşiv nesnelerini geri yüklerken veri alma istekleri için ücretlendirilirsiniz. Daha fazla bilgi için bkz. İstek ü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 ücretleri tahakkuk eder. Daha fazla bilgi için bkz. Depolama ücretleri.

  • Bir Soğuk Arşiv veya Derin Soğuk Arşiv nesnesini geri yüklediğinizde geçici erişim için nesnenin bir Standard çoğaltması oluşturulur. Soğuk Arşiv veya Derin Soğuk Arşiv nesnesi dondurulmuş duruma dönene kadar çoğaltmanın geçici depolanması Standard depolama sınıfına göre ücretlendirilir. Daha fazla bilgi için bkz. Geçici depolama ücretleri.

  • Bir Arşiv nesnesi en fazla yedi gün boyunca geri yüklenmiş durumda kalabilir. Bir Soğuk Arşiv veya Derin Soğuk Arşiv nesnesi en fazla 365 gün boyunca geri yüklenmiş durumda kalabilir. Nesne geri yüklenmiş durumdayken veri alma ücreti tahakkuk etmez.

  • Nesnenin geri yüklenmiş durumda kaldığı süre sona erdiğinde nesne dondurulmuş duruma döner. Nesne dondurulmuş duruma döndükten sonra tekrar geri yüklerseniz veri alma ücreti tahakkuk eder.