Mengunggah Bagian (PUT UploadID) - Amazon S3 Glacier
DeskripsiPermintaanResponsContohBagian Terkait

Halaman ini hanya untuk pelanggan lama dari layanan S3 Glacier menggunakan Vaults dan asli dari 2012. REST API

Jika Anda mencari solusi penyimpanan arsip, kami sarankan untuk menggunakan kelas penyimpanan S3 Glacier di Amazon S3, Pengambilan Instan Gletser S3, Pengambilan Fleksibel Gletser S3, dan S3 Glacier Deep Archive. Untuk mempelajari lebih lanjut tentang opsi penyimpanan ini, lihat Kelas penyimpanan S3 Glacier dan Penyimpanan data jangka panjang menggunakan kelas penyimpanan S3 Glacier di Panduan Pengguna Amazon S3. Kelas penyimpanan ini menggunakan Amazon S3API, tersedia di semua wilayah, dan dapat dikelola dalam konsol Amazon S3. Mereka menawarkan fitur seperti Analisis Biaya Penyimpanan, Lensa Penyimpanan, fitur enkripsi opsional canggih, dan banyak lagi.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengunggah Bagian (PUT UploadID)

Deskripsi

Operasi unggahan multipart ini mengunggah bagian dari arsip. Anda dapat mengunggah bagian arsip dalam urutan apa pun karena dalam permintaan Unggah Bagian, Anda menentukan rentang byte dalam arsip yang disusun yang akan diunggah di bagian ini. Anda juga dapat mengunggah bagian ini secara paralel. Anda dapat mengunggah hingga 10.000 bagian untuk unggahan multipart.

Untuk informasi tentang unggahan multipart, lihat Mengunggah Arsip Besar dalam Beberapa Bagian (Unggahan Multipart).

Amazon S3 Glacier (S3 Glacier) menolak permintaan unggah bagian Anda jika salah satu kondisi berikut ini benar:

  • Hash pohon SHA256 tidak cocok—Untuk memastikan ahwa bagian data tidak rusak dalam transmisi, Anda menghitung hash pohon SHA256 dari bagian dan memasukkannya ke dalam permintaan Anda. Setelah menerima data bagian, S3 Glacier juga menghitung hash pohon SHA256. Jika dua nilai hash tidak cocok, operasi gagal. Untuk informasi tentang mengomputasi hash pohon SHA256, lihat Checksum Komputasi.

  • Hash linear SHA256 tidak cocok—Diperlukan untuk otorisasi, Anda menghitung hash linear SHA256 dari seluruh muatan yang diunggah dan memasukkannya ke dalam permintaan Anda. Untuk informasi tentang mengomputasi hash linear SHA256, lihat Checksum Komputasi.

  • Ukuran bagian tidak cocok—Ukuran setiap bagian kecuali yang terakhir harus sesuai dengan ukuran yang ditentukan dalam permintaan Memulai Unggahan Multipart (POST multipart-uploads) yang sesuai. Ukuran bagian terakhir harus berukuran sama dengan, atau lebih kecil dari, ukuran yang ditentukan.

    catatan

    Jika Anda mengunggah bagian yang ukurannya lebih kecil dari ukuran bagian yang Anda tentukan dalam permintaan mulai unggahan multipart Anda dan bagian tersebut bukan bagian terakhir, permintaan unggah bagian akan berhasil. Namun, permintaan Selesaikan Unggahan Multipart berikutnya akan gagal.

  • Rentang tidak selaras—Nilai rentang byte dalam permintaan tidak selaras dengan ukuran bagian yang ditentukan dalam permintaan mulai yang sesuai. Sebagai contoh, jika Anda menentukan ukuran bagian sebesar 4194304 byte (4 MB), 0 hingga 4194303 byte (4 MB —1) dan 4194304 (4 MB) hingga 8388607 (8 MB —1) adala rentang bagian yang valid. Namun, jika Anda menetapkan nilai rentang sebesar 2 MB hingga 6 MB, rentang tidak selaras dengan ukuran bagian dan unggahan akan gagal.

Operasi ini bersifat idempoten. Jika Anda mengunggah bagian yang sama beberapa kali, data yang disertakan dalam permintaan terbaru akan menimpa data yang diunggah sebelumnya.

Permintaan

Anda mengirim permintaan PUT HTTP ini ke URI ID unggah yang dikembalikan oleh permintaan Mulai Unggahan Multipart Anda. S3 Glacier menggunakan ID unggah untuk mengaitkan unggah sebagian dengan unggahan multipart tertentu. Permintaan harus menyertakan hash pohon SHA256 dari data bagian (x-amz-SHA256-tree-hash), hash linear SHA256 dari seluruh muatan (header x-amz-content-sha256), rentang byte (Content-Range), dan panjang bagian dalam byte (header Content-Length).

Sintaksis

PUT /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Range: ContentRange
Content-Length: PayloadSize
Content-Type: application/octet-stream
x-amz-sha256-tree-hash: Checksum of the part
x-amz-content-sha256: Checksum of the entire payload			
x-amz-glacier-version: 2012-06-01

catatan

Nilai AccountId adalah ID Akun AWS dari akun yang memiliki vault. Anda dapat menentukan ID Akun AWS atau secara opsional satu '-' (tanda hubung), dalam hal ini, Amazon S3 Glacier menggunakan ID Akun AWS yang terkait dengan kredensial yang digunakan untuk menandatangani permintaan. Jika Anda menggunakan ID akun, jangan sertakan tanda hubung ('-') di ID.

Parameter Permintaan

Operasi ini tidak menggunakan parameter permintaan.

Header Permintaan

Operasi ini menggunakan header permintaan berikut, selain header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat Header Permintaan Umum.

Nama Deskripsi Wajib
Content-Length

Mengidentifikasi panjang bagian dalam byte.

Tipe: String

Default: Tidak ada

Batasan: Tidak Ada

 Tidak
Content-Range

Mengidentifikasi rentang byte dalam arsip yang disusun yang akan diunggah di bagian ini. S3 Glacier selanjutnya menggunakan informasi ini untuk menyusun arsip dalam urutan yang benar. Format header ini mengikuti RFC 2616. Contoh header adalah Content-Range:bytes 0-4194303/*.

Tipe: String

Default: Tidak ada

Batasan: Rentang tidak dapat lebih besar dari ukuran bagian yang Anda tentukan ketika Anda memulai unggahan multipart.

Ya
x-amz-content-sha256

Checksum SHA256 (hash linear) dari muatan yang diunggah. Ini bukan nilai yang sama seperti yang Anda tentukan di header x-amz-sha256-tree-hash.

Tipe: String

Default: Tidak ada

Batasan: Tidak Ada

 Ya
x-amz-sha256-tree-hash​

Menentukan hash pohon SHA256 dari data yang diunggah. Untuk informasi tentang mengomputasi hash pohon SHA256, lihat Checksum Komputasi.

Tipe: String

Default: Tidak ada

Batasan: Tidak Ada

 Ya

Isi Permintaan

Isi permintaan berisi data untuk diunggah.

Respons

Setelah unggah bagian berhasil, S3 Glacier mengembalikan respons 204 No Content.

Sintaksis

HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier

Header Respons

Respons yang sukses termasuk header respon berikut, selain header respons yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header respons umum, lihat Header Respons Umum.

Nama Deskripsi
x-amz-sha256-tree-hash​

Hash pohon SHA256 yang S3 Glacier hitung untuk bagian yang diunggah.

Tipe: String

Isi Respons

Operasi ini tidak mengembalikan isi respons.

Contoh

Permintaan berikut mengunggah bagian sebesar 4 MB. Permintaan menetapkan rentang byte untuk membuat ini sebagai bagian pertama dalam arsip.

Contoh Permintaan

Contoh mengirimkan permintaan PUT HTTP untuk mengunggah bagian sebesar 4 MB. Permintaan dikirim ke URI ID Unggah yang dikembalikan oleh permintaan Mulai Unggahan Multipart Anda. Header Content-Range mengidentifikasi bagian sebagai bagian data 4 MB pertama dari arsip.

PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Range:bytes 0-4194303/*
x-amz-sha256-tree-hash:c06f7cd4baacb087002a99a5f48bf953
x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
Content-Length: 4194304
Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace

Untuk mengunggah bagian selanjutnya, prosedurnya sama; namun, Anda harus menghitung hash pohon SHA256 baru dari bagian yang Anda unggah dan juga menentukan rentang byte baru untuk menunjukkan tempat bagian tersebut akan masuk dalam penyusunan final. Permintaan berikut mengunggah bagian lain menggunakan ID unggah yang sama. Permintaan menentukan 4 MB berikutnya dari arsip setelah permintaan sebelumnya dan ukuran bagian sebesar 4 MB.

PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Range:bytes 4194304-8388607/*
Content-Length: 4194304
x-amz-sha256-tree-hash:f10e02544d651e2c3ce90a4307427493
x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
x-amz-glacier-version: 2012-06-01
Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20120525/us-west-2/glacier/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version, Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace

Bagian-bagiannya dapat diunggah dalam urutan apa pun; S3 Glacier menggunakan spesifikasi rentang untuk setiap bagian guna menentukan urutan penyusunannya.

Contoh Respons

HTTP/1.1 204 No Content
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
x-amz-sha256-tree-hash: c06f7cd4baacb087002a99a5f48bf953
Date: Wed, 10 Feb 2017 12:00:00 GMT