File arsip auto-ekstrak¶

Permintaan arsip auto-extract¶

Untuk meng-upload file arsip, buat permintaan PUT. Tambahkan query parameter extract-archive=format untuk menunjukkan bahwa Anda meng-upload file arsip tar bukannya konten normal.

Nilai yang valid untuk variable format adalah tar, tar.gz, atau tar.bz2.

Path yang Anda tentukan dalam permintaan PUT digunakan untuk lokasi objek dan awalan (prefix) untuk nama objek yang dihasilkan.

Dalam permintaan PUT, Anda dapat menentukan jalan (path) untuk:

• Sebuah akun (account)
• Opsional, wadah spesifik (specific container)
• Opsional, awalan objek spesifik (specific object prefix)

Misalnya, jika objek pertama dalam arsip tar adalah /home/file1.txt dan Anda menentukan path /v1/12345678912345/mybackup/castor/, operasi membuat objek castor/home/file1.txt di container mybackup di akun 12345678912345.

Buat arsip untuk auto-extract¶

Anda harus menggunakan tar utility untuk membuat file arsip tar.

Anda dapat meng-upload file biasa tetapi Anda tidak dapat meng-upload item lainnya (misalnya, direktori kosong atau link simbolik).

Anda harus utf-8-encode nama anggota.

Fitur auto-extract arsip mendukung format ini:

• Format POSIX.1-1988 Ustar.

• Format tar GNU. Termasuk nama panjang, hubungan yang panjang, dan ekstensi jarang.

• Format pax POSIX.1-2001

  Gunakan gzip atau bzip2 untuk kompres arsip.

  Gunakan parameter query extract-archive untuk menentukan format. Nilai yang valid untuk parameter ini adalah tar, tar.gz, atau tar.bz2.

Tanggapan (response) arsip auto-extract¶

Ketika Object Storage memproses permintaan, ia melakukan beberapa sub-operasi. Bahkan jika semua sub-operasi gagal, operasi mengembalikan status Created 201. Beberapa sub-operasi mungkin berhasil sementara yang lain gagal. Periksa respon body untuk menentukan hasil setiap sub-operation arsip auto-extract

Anda dapat mengatur header permintaan Accept ke salah satu nilai ini untuk menentukan format respon:

text/plain

Format respon sebagai teks biasa. Jika Anda menghilangkan header Accept, dan text/plain adalah default.

application/json

Format respon sebagai JSON.

application/xml

Format respon sebagai XML.

text/xml

Format respon sebagai XML.

Berikut auto-extract file arsip contoh menunjukkan response body text/plain dimana ada kegagalan terjadi:

Number Files Created: 10
Errors:

Berikut contoh file arsip auto-extract menunjukkan respon text/plain dimana beberapa kegagalan terjadi. Dalam contoh ini, sistem Object Storage dikonfigurasi untuk menolak karakter string tertentu sehingga terjadi 400 Bad Request error untuk setiap objek yang menggunakan string dibatasi.

Number Files Created: 8
Errors:
/v1/12345678912345/mycontainer/home/xx%3Cyy, 400 Bad Request
/v1/12345678912345/mycontainer/../image.gif, 400 Bad Request

Contoh berikut menunjukkan respon kegagalan dalam format application/json.

{
   "Number Files Created":1,
   "Errors":[
      [
         "/v1/12345678912345/mycontainer/home/xx%3Cyy",
         "400 Bad Request"
      ],
      [
         "/v1/12345678912345/mycontainer/../image.gif",
         "400 Bad Request"
      ]
   ]
}