**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](https://aws.amazon.com/s3/storage-classes/glacier/). Amazon Glacier (layanan berbasis brankas mandiri asli) tidak lagi menerima pelanggan baru. 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](https://aws.amazon.com/s3/storage-classes/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](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/). 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)](uploading-archive-mpu.md). 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, lihat[Checksum Komputasi](checksum-calculations.md). + **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, lihat[Checksum Komputasi](checksum-calculations.md). + **Ukuran bagian tidak cocok—**Ukuran setiap bagian kecuali yang terakhir harus sesuai dengan ukuran yang ditentukan dalam permintaan [Memulai Unggahan Multipart (POST multipart-uploads)](api-multipart-initiate-upload.md) 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-hash`header), hash SHA256 linier dari seluruh payload (`x-amz-content-sha256`header), rentang byte (`Content-Range`header), dan panjang bagian dalam byte (header). `Content-Length` ### Sintaksis ``` 1. PUT /{{AccountId}}/vaults/{{VaultName}}/multipart-uploads/{{uploadID}} HTTP/1.1 2. Host: glacier.{{Region}}.amazonaws.com 3. Date: {{Date}} 4. Authorization: {{SignatureValue}} 5. Content-Range: {{ContentRange}} 6. Content-Length: {{PayloadSize}} 7. Content-Type: application/octet-stream 8. x-amz-sha256-tree-hash: {{Checksum of the part}} 9. x-amz-content-sha256: {{Checksum of the entire payload}} 10. x-amz-glacier-version: 2012-06-01 ``` **catatan** `AccountId`Nilainya 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](api-common-request-headers.md). | 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](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16). 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, lihat[Checksum Komputasi](checksum-calculations.md).
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 ``` 1. HTTP/1.1 204 No Content 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. 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](api-common-response-headers.md). | 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. ``` 1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Range:bytes 0-4194303/* 5. x-amz-sha256-tree-hash:c06f7cd4baacb087002a99a5f48bf953 6. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628 7. Content-Length: 4194304 8. 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. ``` 1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Range:bytes 4194304-8388607/* 5. Content-Length: 4194304 6. x-amz-sha256-tree-hash:f10e02544d651e2c3ce90a4307427493 7. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628 8. x-amz-glacier-version: 2012-06-01 9. 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 ``` 1. HTTP/1.1 204 No Content 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. x-amz-sha256-tree-hash: c06f7cd4baacb087002a99a5f48bf953 4. Date: Wed, 10 Feb 2017 12:00:00 GMT ``` ## Bagian Terkait + [Memulai Unggahan Multipart (POST multipart-uploads)](api-multipart-initiate-upload.md) + [Mengunggah Bagian (PUT UploadID)](#api-upload-part) + [Menyelesaikan Unggahan Multipart (POST uploadID)](api-multipart-complete-upload.md) + [Membatalkan Unggahan Multipart (DELETE uploadID)](api-multipart-abort-upload.md) + [Mencantumkan Unggahan Multipart (GET multipart-uploads)](api-multipart-list-uploads.md) + [Mencantumkan Bagian (GET uploadID)](api-multipart-list-parts.md) + [Mengunggah Arsip Besar dalam Beberapa Bagian (Unggahan Multipart)](uploading-archive-mpu.md) + [Identity and Access Management untuk Amazon Glacier](security-iam.md)