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:RestoreObjectiznine sahip olmanız gerekir. Nesneleri dizin bazında geri yüklemek için iseoss:RestoreObjectveoss:ListObjectsizinlerine 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.
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
|
|
--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
|
|
--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. |
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.
NotListe 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/key2ossutil 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.
NotEnvanter 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.