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:RestoreObjectizni gerekir. Daha fazla bilgi için bkz. Özel ilke atama.restore-objectkomutu 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 (
Daysparametresi 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çindeCopyObjectkullanarak 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.
Başlangıçta nesne dondurulmuş durumdadır.
Geri yükleme isteği gönderdikten sonra nesne geri yükleniyor durumuna geçer.
Sunucu tarafındaki görev tamamlandığında nesne geri yüklenmiş duruma geçer. Artık nesneyi okuyabilirsiniz.
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.
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 |
|
Derin Soğuk Arşiv |
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
Komut sözdizimi
ossutil api restore-object --bucket value --key value [flags]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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" } }
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.xmladı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.jsonadı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.xmladı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.jsonadı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.