Mengunggah Bagian (PUT UploadID) - Amazon Glacier
DeskripsiPermintaanResponsContohBagian Terkait

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

Jika Anda mencari solusi penyimpanan arsip, sebaiknya gunakan kelas penyimpanan Amazon Glacier di Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval, dan S3 Glacier Deep Archive. Untuk mempelajari lebih lanjut tentang opsi penyimpanan ini, lihat kelas penyimpanan Amazon Glacier.

Amazon Glacier (layanan berbasis brankas mandiri asli) tidak akan lagi menerima pelanggan baru mulai 15 Desember 2025, tanpa berdampak pada pelanggan yang sudah ada. Amazon Glacier adalah layanan mandiri dengan miliknya APIs sendiri yang menyimpan data di brankas dan berbeda dari Amazon S3 dan kelas penyimpanan Amazon S3 Glacier. Data Anda yang ada akan tetap aman dan dapat diakses di Amazon Glacier tanpa batas waktu. Tidak diperlukan migrasi. Untuk penyimpanan arsip jangka panjang berbiaya rendah, AWS rekomendasikan kelas penyimpanan Amazon S3 Glacier, yang memberikan pengalaman pelanggan yang unggul dengan APIs berbasis ember S3, ketersediaan penuh, biaya lebih rendah, Wilayah AWS dan integrasi layanan. AWS Jika Anda ingin meningkatkan kemampuan, pertimbangkan untuk bermigrasi ke kelas penyimpanan Amazon S3 Glacier dengan menggunakan Panduan Solusi AWS kami untuk mentransfer data dari kubah Amazon Glacier ke kelas penyimpanan Amazon S3 Glacier.

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 Glacier (Amazon Glacier) menolak permintaan bagian unggah Anda jika salah satu dari kondisi berikut ini benar:

  • SHA256 hash pohon tidak cocok— Untuk memastikan bahwa data bagian tidak rusak dalam transmisi, Anda menghitung hash SHA256 pohon dari bagian tersebut dan memasukkannya ke dalam permintaan Anda. Setelah menerima data bagian, Amazon Glacier juga menghitung SHA256 hash pohon. Jika dua nilai hash tidak cocok, operasi gagal. Untuk informasi tentang menghitung hash SHA256 pohon, lihatChecksum Komputasi.

  • SHA256 hash linier tidak cocok— Diperlukan untuk otorisasi, Anda menghitung hash SHA256 linier dari seluruh muatan yang diunggah dan memasukkannya ke dalam permintaan Anda. Untuk informasi tentang menghitung hash SHA256 linier, lihatChecksum 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. Amazon Glacier menggunakan ID unggahan untuk mengaitkan unggahan bagian dengan unggahan multibagian tertentu. Permintaan harus menyertakan hash SHA256 pohon dari data bagian (x-amz-SHA256-tree-hashheader), hash SHA256 linier dari seluruh payload (x-amz-content-sha256header), rentang byte (Content-Rangeheader), 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

AccountIdNilainya adalah Akun AWS ID akun yang memiliki brankas. Anda dapat menentukan Akun AWS ID atau secara opsional satu '-' (tanda hubung), dalam hal ini Amazon Glacier menggunakan Akun AWS ID yang terkait dengan kredenal 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. Amazon Glacier menggunakan informasi ini untuk mengumpulkan arsip dalam urutan yang tepat. 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

SHA256 Checksum (hash linier) dari payload 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 SHA256 pohon dari data yang diunggah. Untuk informasi tentang menghitung hash SHA256 pohon, lihatChecksum Komputasi.

Tipe: String

Default: Tidak ada

Batasan: Tidak Ada

 Ya

Isi Permintaan

Isi permintaan berisi data untuk diunggah.

Respons

Setelah pengunggahan bagian yang berhasil, Amazon 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 Penjelasan
x-amz-sha256-tree-hash​

Hash SHA256 pohon yang dihitung Amazon Glacier 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 SHA256 pohon baru dari bagian yang Anda unggah dan juga menentukan rentang byte baru untuk menunjukkan ke mana bagian tersebut akan pergi dalam perakitan akhir. 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

Suku cadang dapat diunggah dalam urutan apa pun; Amazon Glacier menggunakan spesifikasi rentang untuk setiap bagian untuk menentukan urutan untuk merakitnya.

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