Object Storage Service:Use the restore command to restore objects

Notlar

• Tek bir nesneyi geri yüklemek için oss:RestoreObject iznine sahip olmanız gerekir. Bir klasördeki birden çok nesneyi geri yüklemek için oss:RestoreObject ve oss:ListObjects izinlerine sahip olmalısınız. Daha fazla bilgi için bkz. RAM kullanıcısına özel izinler atama.

• ossutil 1.6.16 ve sonraki sürümlerden itibaren, kullandığınız işletim sisteminden bağımsız olarak komut satırında ikili dosya adı olarak ossutil kullanabilirsiniz. 1.6.16'dan önceki bir ossutil sürümü kullanıyorsanız, işletim sisteminize göre ikili dosya adını değiştirmeniz gerekir. Daha fazla bilgi için bkz. ossutil komut referansı.

• Arşiv, Soğuk Arşiv veya Derin Soğuk Arşiv nesnelerinin geri yükleme durumu ve faturalandırması hakkında daha fazla bilgi için bkz. Nesneleri geri yükleme.

• Bu komut yalnızca ossutil 1.7.11 ve sonraki sürümlerde kullanılabilir.

Komut sözdizimi

ossutil restore oss://bucketname[/prefix][local_xml_file]
[--encoding-type <value>]
[--payer <value>]
[--version-id <value>]
[-r, --recursive]
[-f, --force] 
[--object-file, <value>]
[--snapshot-path, <value>]
[--disable-ignore-error]
[--retry-times <value>]
[-j，--job <value>]

Aşağıdaki tabloda komuttaki parametreler ve seçenekler açıklanmaktadır.

Arşiv nesnelerini geri yükleme

Bir Arşiv nesnesinin geri yüklenmesi yaklaşık bir dakika sürer. Nesne geri yüklenirken okunamaz.

Varsayılan olarak, geri yüklenen bir nesne bir gün boyunca geri yüklenmiş durumda kalır. Zaten geri yüklenmiş bir nesnede restore komutunu çalıştırırsanız geri yüklenmiş durumu bir gün uzatılır. Geri yüklenmiş durum en fazla yedi gün uzatılabilir. Bu sürenin ardından nesne dondurulmuş duruma döner.

<RestoreRequest>
    <Days>3</Days>
</RestoreRequest>

• Tek bir Arşiv nesnesini geri yükleme

  • Aşağıdaki örnek, examplebucket paketindeki exampleobject.txt adlı bir Arşiv nesnesinin nasıl geri yükleneceğini ve nesnenin üç gün boyunca geri yüklenmiş durumda tutulacağını gösterir.

    ossutil restore oss://examplebucket/exampleobject.txt config.xml

  • Aşağıdaki örnek, examplebucket paketindeki exampleobject.txt adlı Arşiv nesnesinin belirli bir sürümünün nasıl geri yükleneceğini gösterir.

    ossutil restore oss://examplebucket/exampleobject.txt --version-id  CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3**** config.xml

    Bir nesnenin tüm sürümlerini elde etme hakkında daha fazla bilgi için bkz. ls (Hesap düzeyi kaynakları listeleme).

• Birden çok Arşiv nesnesini geri yükleme

  • Örnek 1: Farklı klasörlerdeki nesneler

    Kök klasördeki exampleobject1.jpg, dir1/ klasöründeki exampleobject2.png ve dir2/ klasöründeki exampleobject3.txt gibi examplebucket paketinin farklı klasörlerinde bulunan birden çok Arşiv nesnesini geri yüklemek için aşağıdaki adımları uygulayın.

    1. Geri yüklemek istediğiniz Arşiv nesnelerinin adlarını localfile.txt yerel dosyasına yazın.

       exampleobject1.jpg
       dir1/exampleobject2.png
       dir2/exampleobject3.txt

    2. config.xml dosyasında geri yüklenmiş durumun üç gün sürmesini ayarlayın.

       <RestoreRequest>
           <Days>3</Days>
       </RestoreRequest>

    3. Birden çok Arşiv nesnesini geri yükleyin.

       examplebucket paketindeki birden çok Arşiv nesnesini geri yüklemek için --object-file seçeneğini kullanın.

       ossutil restore oss://examplebucket --object-file localfile.txt --snapshot-path dir/ config.xml

  • Örnek 2: Aynı klasördeki nesneler

    • Yöntem 1

      Bir paketin aynı klasöründeki birden çok Arşiv nesnesini geri yüklemek için Örnek 1 bölümüne bakabilirsiniz.

    • Yöntem 2

      examplebucket paketindeki belirtilen dest klasöründen tüm Arşiv nesnelerini geri yüklemek için -r seçeneğini kullanabilirsiniz.

      ossutil restore oss://examplebucket/dest -r config.xml

• Çıktı

  İşlem başarılı olursa çıktı, geri yükleme isteğinin başlatıldığı zamanı içerir. Örnek:

  0.106852(s) elapsed

Soğuk Arşiv nesnelerini geri yükleme

Bir veya daha fazla Soğuk Arşiv nesnesini geri yüklemeden önce config.xml adlı yerel bir XML dosyası oluşturun ve dosyada aşağıdaki geri yükleme parametrelerini yapılandırın.

<RestoreRequest>
    <Days>3</Days>
    <JobParameters>
        <Tier>Bulk</Tier>
    </JobParameters>
</RestoreRequest>

Aşağıdaki tabloda parametreler açıklanmaktadır.

• Tek bir Soğuk Arşiv nesnesini geri yükleme

  Aşağıdaki komut, config.xml dosyasındaki yapılandırmalara dayanarak examplebucket paketindeki exampleobject.jpg nesnesini 1 saat içinde geri yükler ve nesneyi üç gün boyunca geri yüklenmiş durumda tutar.

  ossutil restore oss://examplebucket/exampleobject.jpg config.xml

• Birden çok Soğuk Arşiv nesnesini geri yükleme

  • Örnek 1: Farklı klasörlerdeki nesneler

    Kök klasördeki exampleobject1.jpg, dir1/ klasöründeki exampleobject2.png ve dir2/ klasöründeki exampleobject3.txt gibi examplebucket paketinin farklı klasörlerinde bulunan birden çok Soğuk Arşiv nesnesini geri yüklemek için aşağıdaki adımları uygulayın.

    1. Geri yüklenecek Soğuk Arşiv nesnelerinin adlarını localfile.txt yerel dosyasına yazın.

       exampleobject1.jpg
       dir1/exampleobject2.png
       dir2/exampleobject3.txt

    2. Birden çok nesneyi geri yükleyin.

       examplebucket paketindeki birden çok Soğuk Arşiv nesnesini geri yüklemek için --object-file seçeneğini kullanın. config.xml dosyasındaki yapılandırmalara dayanarak nesneler 1 saat içinde geri yüklenir ve üç gün boyunca geri yüklenmiş durumda tutulur.

       ossutil restore oss://examplebucket --object-file localfile.txt --snapshot-path dir/ config.xml

  • Örnek 2: Aynı klasördeki nesneler

    • Yöntem 1

      Bir paketin aynı klasöründeki birden çok Soğuk Arşiv nesnesini geri yüklemek için Örnek 1 bölümüne bakabilirsiniz.

    • Yöntem 2

      examplebucket paketinin dest klasöründen tüm Soğuk Arşiv nesnelerini geri yüklemek için -r seçeneğini kullanın.

      ossutil restore oss://examplebucket/dest -r config.xml

• Çıktı

  İşlem başarılı olursa çıktı, geri yükleme isteğinin başlatılması için geçen süreyi içerir. Örneğin:

  0.106852(s) elapsed

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

Bir veya daha fazla Derin Soğuk Arşiv nesnesini geri yüklemeden önce config.xml adlı yerel bir XML dosyası oluşturun ve dosyada aşağıdaki geri yükleme parametrelerini yapılandırın.

<RestoreRequest>
    <Days>3</Days>
    <JobParameters>
        <Tier>Standard</Tier>
    </JobParameters>
</RestoreRequest>

Yapılandırma parametreleri şu şekildedir:

• Tek bir Derin Soğuk Arşiv nesnesini geri yükleme

  config.xml dosyasındaki yapılandırmalara dayanarak aşağıdaki komut, examplebucket paketindeki exampleobject.jpg nesnesini 48 saat içinde geri yükler ve nesneyi üç gün boyunca geri yüklenmiş durumda tutar.

  ossutil restore oss://examplebucket/exampleobject.jpg config.xml

• Birden çok Derin Soğuk Arşiv nesnesini geri yükleme

  • Örnek 1: Farklı klasörlerdeki nesneler

    Kök klasördeki exampleobject1.jpg, dir1/ klasöründeki exampleobject2.png ve dir2/ klasöründeki exampleobject3.txt gibi examplebucket paketinin farklı klasörlerinde bulunan birden çok Derin Soğuk Arşiv nesnesini geri yüklemek için aşağıdaki adımları uygulayın.

    1. Geri yüklenecek Derin Soğuk Arşiv nesnelerinin adlarını localfile.txt yerel dosyasına ekleyin.

       exampleobject1.jpg
       dir1/exampleobject2.png
       dir2/exampleobject3.txt

    2. Birden çok nesneyi geri yükleyin.

       examplebucket paketindeki birden çok Derin Soğuk Arşiv nesnesini 48 saat içinde geri yüklemek ve bunları üç gün boyunca geri yüklenmiş durumda tutmak için --object-file seçeneğini kullanın. Bu işlem config.xml dosyasındaki yapılandırmalara dayanır.

       ossutil restore oss://examplebucket --object-file localfile.txt --snapshot-path dir/ config.xml

  • Örnek 2: Aynı klasördeki nesneler

    • Yöntem 1

      Bir paketin aynı klasöründeki birden çok Derin Soğuk Arşiv nesnesini geri yüklemek için Örnek 1 bölümüne bakabilirsiniz.

    • Yöntem 2

      examplebucket paketinin dest klasöründeki tüm Derin Soğuk Arşiv nesnelerini geri yüklemek için -r seçeneğini kullanın.

      ossutil restore oss://examplebucket/dest -r config.xml

• Çıktı

  İşlem başarılı olursa çıktı, geri yükleme isteğinin başlatılması için geçen süreyi gösterir. Örneğin:

  0.106852(s) elapsed

Ortak seçenekler

Farklı bir bölgedeki bir pakete erişmek için uç noktayı belirtmek üzere -e seçeneğini kullanın. Farklı bir Alibaba Cloud hesabına ait bir pakete erişmek için AccessKey ID için -i ve AccessKeySecret için -k seçeneğini kullanın.

Örneğin, Çin (Şanghay) bölgesinde bulunan ve başka bir Alibaba Cloud hesabına ait olan testbucket paketindeki exampletest.png nesnesini geri yüklemek için aşağıdaki komutu çalıştırın:

ossutil restore oss://testbucket/exampletest.png -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

Ortak seçenekler.

İlgili Konular

• Bir nesnenin geri yüklenip yüklenmediğini kontrol etmek için bkz. stat (Paket ve nesne bilgilerini görüntüleme).

• Bir OSS nesnesini kalıcı olarak geri yüklenmiş durumda tutmak için bkz. Bir OSS nesnesini kalıcı olarak geri yüklenmiş durumda nasıl tutabilirim?.