**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.
# Operasi Unggahan Multipart
Berikut ini adalah operasi pengunggahan multibagian yang tersedia untuk digunakan di Amazon Glacier.
**Topics**
+ [Membatalkan Unggahan Multipart (DELETE uploadID)](api-multipart-abort-upload.md)
+ [Menyelesaikan Unggahan Multipart (POST uploadID)](api-multipart-complete-upload.md)
+ [Memulai Unggahan Multipart (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Mencantumkan Bagian (GET uploadID)](api-multipart-list-parts.md)
+ [Mencantumkan Unggahan Multipart (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [Mengunggah Bagian (PUT UploadID)](api-upload-part.md)
# Membatalkan Unggahan Multipart (DELETE uploadID)
## Deskripsi
Perintah untuk operasi unggahan multipart ini menghentikan unggahan multipart yang diidentifikasi oleh ID unggahan.
Setelah permintaan Hentikan Unggahan Multipart berhasil, Anda tidak dapat menggunakan ID unggah untuk mengunggah lebih banyak bagian atau melakukan operasi lainnya. Gagal menghentikan unggahan multipart yang selesai. Namun, menghentikan unggahan yang sudah berhenti akan berhasil, untuk waktu yang singkat.
Operasi ini bersifat idempoten.
Untuk informasi tentang unggahan multipart, lihat [Mengunggah Arsip Besar dalam Beberapa Bagian (Unggahan Multipart)](uploading-archive-mpu.md).
## Permintaan
Untuk menghentikan unggahan multipart, kirim permintaan `DELETE` HTTP ke URI subsumber daya `multipart-uploads` vault dan mengidentifikasi ID unggahan multipart tertentu sebagai bagian dari URI.
### Sintaksis
```
1. DELETE /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. 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 hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat [Header Permintaan Umum](api-common-request-headers.md).
### Isi Permintaan
Operasi ini tidak memiliki isi permintaan.
## Respons
### Sintaksis
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### Header Respons
Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat [Header Respons Umum](api-common-response-headers.md).
### Isi Respons
Operasi ini tidak mengembalikan isi respons.
### Kesalahan
Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, lihat. [Respons Kesalahan](api-error-responses.md)
## Contoh
### Contoh Permintaan
Dalam contoh berikut, permintaan `DELETE` dikirim ke URI dari sumber daya ID unggahan multipart.
```
1. DELETE /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```
### Contoh Respons
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. 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.md)
+ [Menyelesaikan Unggahan Multipart (POST uploadID)](api-multipart-complete-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)
# Menyelesaikan Unggahan Multipart (POST uploadID)
## Deskripsi
Anda memanggil operasi pengunggahan multibagian ini untuk memberi tahu Amazon Glacier (Amazon Glacier) bahwa semua bagian arsip telah diunggah dan Amazon Glacier sekarang dapat merakit arsip dari bagian yang diunggah.
Untuk informasi tentang unggahan multipart, lihat [Mengunggah Arsip Besar dalam Beberapa Bagian (Unggahan Multipart)](uploading-archive-mpu.md).
Setelah merakit dan menyimpan arsip ke lemari besi, Amazon Glacier mengembalikan ID arsip sumber daya arsip yang baru dibuat. Setelah mengunggah arsip, Anda harus menyimpan ID arsip yang dikembalikan untuk mengambil arsip di titik berikutnya.
Dalam permintaan, Anda harus menyertakan hash SHA256 pohon yang dihitung dari seluruh arsip yang telah Anda unggah. Untuk informasi tentang menghitung hash SHA256 pohon, lihat[Checksum Komputasi](checksum-calculations.md). Di sisi server, Amazon Glacier juga membangun hash pohon SHA256 dari arsip yang dirakit. Jika nilainya cocok, Amazon Glacier menyimpan arsip ke brankas; jika tidak, ia mengembalikan kesalahan, dan operasi gagal. Operasi [Mencantumkan Bagian (GET uploadID)](api-multipart-list-parts.md) mengembalikan daftar bagian yang diunggah untuk unggahan multipart tertentu. Ini termasuk informasi checksum untuk setiap bagian yang diunggah yang dapat digunakan untuk melakukan debug masalah checksum yang buruk.
Selain itu, Amazon Glacier juga memeriksa rentang konten yang hilang. Ketika mengunggah bagian, Anda menentukan nilai kisaran yang mengidentifikasi tempat setiap bagian cocok dalam penyusunan final arsip. Saat merakit arsip akhir Amazon Glacier memeriksa rentang konten yang hilang dan jika ada rentang konten yang hilang, Amazon Glacier mengembalikan kesalahan dan operasi Unggah Multipart Lengkap gagal.
Selesaikan Unggahan Multipart adalah operasi idempoten. Setelah selesaikan unggahan multipart pertama Anda berhasil, jika Anda memanggil operasi lagi dalam waktu singkat, operasi akan berhasil dan mengembalikan ID arsip yang sama. Hal ini berguna jika Anda mengalami masalah jaringan atau menerima kesalahan server 500, dalam hal ini, Anda dapat mengulangi permintaan Selesaikan Unggahan Multipart dan mendapatkan ID arsip yang sama tanpa membuat arsip duplikat. Namun, perhatikan bahwa setelah unggahan multipart selesai, Anda tidak dapat memanggil operasi Cantumkan Bagian dan unggahan multipart tidak akan muncul dalam respond Cantumkan Unggahan Multipart, bahkan jika idempoten selesai dimungkinkan.
## Permintaan
Untuk menyelesaikan unggahan multibagian, Anda mengirim permintaan HTTP POST ke URI ID unggahan yang dibuat Amazon Glacier sebagai tanggapan atas permintaan Inisiate Multipart Upload Anda. Ini adalah URI yang sama dengan yang Anda gunakan saat mengunggah bagian. Selain header umum yang diperlukan, Anda harus menyertakan hasil hash SHA256 pohon dari seluruh arsip dan ukuran total arsip dalam byte.
### Sintaksis
```
1. POST /AccountId/vaults/VaultName/multipart-uploads/uploadID
2. Host: glacier.Region.amazonaws.com
3. Date: date
4. Authorization: SignatureValue
5. x-amz-sha256-tree-hash: SHA256 tree hash of the archive
6. x-amz-archive-size: ArchiveSize in bytes
7. 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 kredensil 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 |
| --- | --- | --- |
| x-amz-archive-size | Ukuran total, dalam byte, dari seluruh arsip. Nilai ini harus jumlah dari semua ukuran masing-masing bagian yang Anda unggah. Tipe: String Default: Tidak ada Batasan: Tidak Ada | Ya |
| x-amz-sha256-tree-hash | Hash SHA256 pohon dari seluruh arsip. Ini adalah hash pohon hash SHA256 pohon dari masing-masing bagian. Jika nilai yang Anda tentukan dalam permintaan tidak cocok dengan hash SHA256 pohon dari arsip rakitan akhir seperti yang dihitung oleh Amazon Glacier, Amazon Glacier mengembalikan kesalahan dan permintaan gagal. Tipe: String Default: Tidak ada Batasan: Tidak Ada | Ya |
### Elemen permintaan
Operasi ini tidak menggunakan elemen permintaan.
## Respons
Amazon Glacier (Amazon Glacier) membuat SHA256 hash pohon dari seluruh arsip. Jika nilainya cocok dengan hash SHA256 pohon dari seluruh arsip yang Anda tentukan dalam permintaan, Amazon Glacier menambahkan arsip ke vault. Sebagai respons, ini mengembalikan header `Location` HTTP dengan jalur URL dari sumber daya arsip yang baru ditambahkan. Jika ukuran arsip atau SHA256 yang Anda kirim dalam permintaan tidak cocok, Amazon Glacier akan mengembalikan kesalahan dan unggahan tetap dalam keadaan tidak lengkap. Dimungkinkan untuk mencoba lagi operasi Selesaikan Unggahan Multipart nanti dengan nilai yang benar, pada saat mana Anda dapat berhasil membuat arsip. Jika unggahan multipart tidak selesai, maka pada akhirnya Amazon Glacier akan merebut kembali ID unggahan tersebut.
### Sintaksis
```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location
x-amz-archive-id: ArchiveId
```
### 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 | Deskripsi |
| --- | --- |
| Location | Jalur URI relatif dari arsip yang baru dibuat. URL ini menyertakan ID arsip yang dihasilkan oleh Amazon Glacier. Tipe: String |
| x-amz-archive-id | ID arsip. Nilai ini juga disertakan sebagai bagian dari header `Location`. Tipe: String |
### Bidang Respons
Operasi ini tidak mengembalikan isi respons.
## Contoh
### Contoh Permintaan
Dalam contoh ini, permintaan HTTP POST dikirim ke URI yang dikembalikan oleh permintaan Mulai Unggahan Multipart. Permintaan menentukan hash SHA256 pohon dari seluruh arsip dan ukuran arsip total.
```
1. POST /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. z-amz-Date: 20170210T120000Z
4. x-amz-sha256-tree-hash:1ffc0f54dd5fdd66b62da70d25edacd0
5. x-amz-archive-size:8388608
6. x-amz-glacier-version: 2012-06-01
7. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```
### Contoh Respons
Contoh respons berikut menunjukkan bahwa Amazon Glacier berhasil membuat arsip dari bagian yang Anda unggah. Respons mencakup ID arsip dengan jalur lengkap.
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
5. x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
```
Anda sekarang dapat mengirim permintaan HTTP ke URI dari sumber/arsip yang baru ditambahkan. Misalnya, Anda dapat mengirim permintaan GET untuk mengambil arsip.
## Bagian Terkait
+ [Memulai Unggahan Multipart (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Mengunggah Bagian (PUT UploadID)](api-upload-part.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)
+ [Menghapus Arsip (DELETE archive)](api-archive-delete.md)
+ [Identity and Access Management untuk Amazon Glacier](security-iam.md)
# Memulai Unggahan Multipart (POST multipart-uploads)
## Deskripsi
Operasi ini memulai unggahan multipart (lihat [Mengunggah Arsip Besar dalam Beberapa Bagian (Unggahan Multipart)](uploading-archive-mpu.md)). Amazon Glacier (Amazon Glacier) membuat sumber daya unggahan multibagian dan mengembalikan ID-nya sebagai respons. Anda menggunakan ID unggahan dalam operasi unggahan multipart selanjutnya.
Ketika memulai unggahan multipart, Anda menentukan ukuran bagian dalam jumlah byte. Ukuran bagian harus mebibyte (MiB) (1024 kibibytes [KiB]) dikalikan dengan kekuatan 2—misalnya, 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB), dan seterusnya. Ukuran bagian minimum yang diijinkan adalah 1 MiB, dan maksimum adalah 4 gibibytes (GiB).
Setiap bagian yang Anda unggah menggunakan ID unggah ini, kecuali yang terakhir, harus memiliki ukuran yang sama. Yang terakhir bisa berukuran sama atau lebih kecil. Misalnya, Anda ingin mengunggah file 16,2 MiB. Jika Anda memulai unggahan multipart dengan ukuran bagian 4 MiB, Anda akan mengunggah empat bagian masing-masing 4 MiB dan satu bagian 0,2 MiB.
**catatan**
Anda tidak perlu mengetahui ukuran arsip saat memulai unggahan multipart karena Amazon Glacier tidak mengharuskan Anda menentukan ukuran arsip keseluruhan.
Setelah Anda menyelesaikan unggahan multibagian, Amazon Glacier menghapus sumber daya unggahan multibagian yang direferensikan oleh ID. Amazon Glacier juga akan menghapus sumber daya unggahan multibagian jika Anda membatalkan unggahan multibagian atau mungkin dihapus jika tidak ada aktivitas selama 24 jam. ID mungkin masih tersedia setelah 24 jam, tetapi aplikasi seharusnya tidak menduga perilaku ini.
## Permintaan
Untuk memulai unggahan multipart, Anda mengirim permintaan `POST` HTTP ke URI subsumber daya `multipart-uploads` dari vault tempat Anda ingin menyimpan arsip. Permintaan harus mencakup ukuran bagian dan secara opsional dapat menyertakan deskripsi arsip.
### Sintaksis
```
1. POST /AccountId/vaults/VaultName/multipart-uploads
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
6. x-amz-archive-description: ArchiveDescription
7. x-amz-part-size: PartSize
```
**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 |
| --- | --- | --- |
| x-amz-part-size | Ukuran setiap bagian kecuali yang terakhir, dalam byte. Bagian terakhir bisa lebih kecil dari ukuran bagian ini. Tipe: String Default: Tidak Ada Kendala: Ukuran bagian harus mebibyte (1024 KiB) dikalikan dengan kekuatan 2 — misalnya, 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB), dan seterusnya. Ukuran bagian minimum yang diijinkan adalah 1 MiB, dan maksimum adalah 4 GiB (4096 MiB). | Ya |
| x-amz-archive-description | Arsipkan deskripsi yang Anda unggah di bagian. Ini bisa menjadi deskripsi bahasa biasa atau beberapa pengidentifikasi unik yang Anda pilih untuk ditetapkan. Saat Anda mengambil inventaris vault (lihat [Memulai Tugas (POST jobs)](api-initiate-job-post.md) ), inventaris mencakup deskripsi ini untuk masing-masing arsip yang dikembalikan sebagai respons. Spasi yang mendahului dalam deskripsi arsip akan dihapus. Tipe: String Default: Tidak ada Batasan: Deskripsi harus kurang dari atau sama dengan 1024 byte. Karakter yang diizinkan adalah ASCII 7 bit tanda kode kontrol, khususnya nilai ASCII 32-126 desimal atau 0x20-0x7E heksadesimal. | Tidak |
### Isi Permintaan
Operasi ini tidak memiliki isi permintaan.
## Respons
Sebagai tanggapan, Amazon Glacier membuat sumber daya unggahan multibagian yang diidentifikasi oleh ID dan mengembalikan jalur URI relatif dari ID unggahan multibagian.
### Sintaksis
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Location: Location
5. x-amz-multipart-upload-id: multiPartUploadId
```
### 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 | Deskripsi |
| --- | --- |
| Location | Jalur URI relatif dari ID unggahan multibagian Amazon Glacier dibuat. Anda menggunakan jalur URI ini untuk mencakup permintaan Anda untuk mengunggah bagian, dan untuk menyelesaikan unggahan multipart. Tipe: String |
| x-amz-multipart-upload-id | ID unggahan multipart. Nilai ini juga disertakan sebagai bagian dari header `Location`. Tipe: String |
### Isi Respons
Operasi ini tidak mengembalikan isi respons.
### Kesalahan
Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, lihat. [Respons Kesalahan](api-error-responses.md)
## Contoh
### Contoh Permintaan
Contoh berikut memulai unggahan multipart dengan mengirimkan permintaan `POST` HTTP ke URI dari subsumber daya `multipart-uploads` dari vault bernama `examplevault`. Permintaan termasuk header untuk menentukan ukuran bagian dari 4 MiB (4194304 byte) dan deskripsi arsip opsional.
```
1. POST /-/vaults/examplevault/multipart-uploads
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-archive-description: MyArchive-101
5. x-amz-part-size: 4194304
6. x-amz-glacier-version: 2012-06-01
7. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```
### Contoh Respons
Amazon Glacier membuat sumber daya unggahan multibagian dan menambahkannya ke subsumber daya brankas`multipart-uploads`. Header respons `Location` termasuk jalur URI relatif ke ID unggahan multipart.
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
5. x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
```
Untuk informasi tentang mengunggah bagian-bagian individu, lihat [Mengunggah Bagian (PUT UploadID)](api-upload-part.md).
## Bagian Terkait
+ [Mengunggah Bagian (PUT UploadID)](api-upload-part.md)
+ [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)
+ [Menghapus Arsip (DELETE archive)](api-archive-delete.md)
+ [Mengunggah Arsip Besar dalam Beberapa Bagian (Unggahan Multipart)](uploading-archive-mpu.md)
+ [Identity and Access Management untuk Amazon Glacier](security-iam.md)
# Mencantumkan Bagian (GET uploadID)
## Deskripsi
Operasi unggahan multipart ini mencantumkan bagian arsip yang telah diunggah dalam unggahan multipart tertentu yang diidentifikasi oleh ID unggah. Untuk informasi tentang unggahan multipart, lihat [Mengunggah Arsip Besar dalam Beberapa Bagian (Unggahan Multipart)](uploading-archive-mpu.md).
Anda dapat membuat permintaan ini kapan saja selama unggahan multipart yang sedang berlangsung sebelum menyelesaikan unggahan multipart. Amazon Glacier mengembalikan daftar bagian yang diurutkan berdasarkan rentang yang Anda tentukan di setiap unggahan bagian. Jika Anda mengirim permintaan Suku Cadang Daftar setelah menyelesaikan unggahan multibagian, Amazon Glacier (Amazon Glacier) mengembalikan kesalahan.
Operasi Cantumkan Bagian mendukung pemberian nomor halaman. Anda harus selalu memeriksa bidang `Marker` dalam isi respons untuk penanda tempat untuk melanjutkan daftar; jika tidak ada lagi item, bidang `marker` adalah `null`. Jika `marker` tidak null, untuk mengambil kumpulan bagian berikutnya, Anda mengirim permintaan Bagian Daftar lain dengan parameter `marker` permintaan yang disetel ke nilai penanda Amazon Glacier yang dikembalikan sebagai tanggapan atas permintaan Bagian Daftar Anda sebelumnya.
Anda juga dapat membatasi jumlah bagian yang dikembalikan dalam respons dengan menentukan parameter `limit` dalam permintaan.
## Permintaan
### Sintaksis
Untuk mencantumkan bagian dari unggahan multipart yang sedang berlangsung, Anda mengirim permintaan `GET` ke URI dari sumber daya ID unggahan multipart. ID unggahan multipart dikembalikan ketika Anda memulai unggahan multipart ([Memulai Unggahan Multipart (POST multipart-uploads)](api-multipart-initiate-upload.md)). Anda dapat secara opsional menentukan parameter `marker` dan `limit`.
```
1. GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. 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
| Nama | Deskripsi | Wajib |
| --- | --- | --- |
| limit | Jumlah maksimum bagian yang dikembalikan. Batas default adalah 50. Jumlah bagian yang dikembalikan mungkin kurang dari batas yang ditentukan, tetapi jumlah bagian yang dikembalikan tidak pernah melebihi batas. Tipe: String Batasan: Nilai bilangan bulat minimum `1`. Nilai bilangan bulat maksimum `50`. | Tidak |
| marker | String buram yang digunakan untuk pemberian nomor halaman. `marker` menentukan bagian tempat cantuman bagian harus dimulai. Dapatkan nilai `marker` dari respons dari respons Cantumkan Bagian sebelumnya. Anda hanya perlu menyertakan `marker` jika Anda melanjutkan pemberian nomor halaman dari hasil yang dimulai dalam permintaan Cantumkan Bagian sebelumnya. Tipe: String Batasan: Tidak Ada | Tidak |
### Header Permintaan
Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat [Header Respons Umum](api-common-response-headers.md).
### Isi Permintaan
Operasi ini tidak memiliki isi permintaan.
## Respons
### Sintaksis
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Content-Type: application/json
5. Content-Length: Length
6.
7. {
8. "ArchiveDescription" : String,
9. "CreationDate" : String,
10. "Marker": String,
11. "MultipartUploadId" : String,
12. "PartSizeInBytes" : Number,
13. "Parts" :
14. [ {
15. "RangeInBytes" : String,
16. "SHA256TreeHash" : String
17. },
18. ...
19. ],
20. "VaultARN" : String
21. }
```
### Header Respons
Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat [Header Respons Umum](api-common-response-headers.md).
### Isi Respons
Isi respons berisi bidang JSON berikut.
**ArchiveDescription**
Deskripsi arsip yang ditentukan dalam permintaan Mulai Unggahan Multipart. Bidang ini adalah `null` jika tidak ada deskripsi arsip yang ditentukan dalam operasi Mulai Unggahan Multipart.
*Tipe*: String
**CreationDate**
Waktu UTC unggahan multipart dimulai.
*Tipe*: String. Representasi string dalam format tanggal ISO 8601, misalnya `2013-03-20T17:03:43.221Z`.
**Penanda**
String buram yang mewakili tempat untuk melanjutkan pemberian nomor halaman hasil. Anda menggunakan `marker` dalam permintaan Cantumkan Bagian baru untuk mendapatkan lebih banyak tugas dalam daftar. Jika tidak ada lagi bagian, nilai ini adalah `null`.
*Tipe*: String
**MultipartUploadId**
ID upload yang bagian-bagiannya terkait.
*Tipe*: String
**PartSizeInBytes**
Ukuran bagian dalam byte. Ini adalah nilai yang sama dengan yang Anda tentukan dalam permintaan Mulai Unggahan Multipart.
*Tipe*: Angka
**Bagian**
Daftar ukuran bagian dari unggahan multipart. Setiap objek dalam array berisi pasangan nama/nilai `RangeBytes` dan `sha256-tree-hash`.
*Tipe*: Array
**RangeInBytes**
Rentang byte bagian, termasuk nilai atas rentang.
*Tipe*: String
**SHA256TreeHash**
Nilai hash SHA256 pohon yang dihitung Amazon Glacier untuk bagian tersebut. Bidang ini tidak pernah ada `null`.
*Tipe*: String
**Vaultarn**
Amazon Resource Name (ARN) dari vault tempat unggahan multipart dimulai.
*Tipe*: String
### Kesalahan
Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, lihat. [Respons Kesalahan](api-error-responses.md)
## Contoh
### Contoh: Mencantumkan Bagian dari Unggahan Multipart
Contoh berikut mencantumkan semua bagian dari unggah. Contoh mengirimkan permintaan `GET` HTTP ke URI ID unggahan multipart spesifik dari unggahan multipart yang sedang berlangsung dan mengembalikan hingga 1.000 bagian.
#### Contoh Permintaan
```
1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```
#### Contoh Respons
Sebagai tanggapan, Amazon Glacier mengembalikan daftar bagian yang diunggah yang terkait dengan ID unggahan multibagian yang ditentukan. Dalam contoh ini, hanya ada dua bagian. Bidang `Marker` yang dikembalikan adalah `null` yang menunjukkan tidak ada lagi bagian dari unggahan multipart.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Type: application/json
5. Content-Length: 412
6.
7. {
8. "ArchiveDescription" : "archive description",
9. "CreationDate" : "2012-03-20T17:03:43.221Z",
10. "Marker": null,
11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
12. "PartSizeInBytes" : 4194304,
13. "Parts" :
14. [ {
15. "RangeInBytes" : "0-4194303",
16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
17. },
18. {
19. "RangeInBytes" : "4194304-8388607",
20. "SHA256TreeHash" : "0195875365afda349fc21c84c099987164"
21. }],
22. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
23. }
```
### Contoh: Mencantumkan Bagian dari Unggahan Multipart (Menentukan Penanda dan Parameter Permintaan Batas)
Contoh berikut menunjukkan cara menggunakan pemberian nomor halaman untuk mendapatkan sejumlah hasil terbatas. Contoh mengirimkan permintaan `GET` HTTP ke URI ID unggahan multipart spesifik dari unggahan multipart yang sedang berlangsung untuk mengembalikan satu bagian. Parameter `marker` yang memulai menentukan di bagian mana untuk memulai daftar bagian. Anda bisa mendapatkan nilai `marker` dari respons permintaan sebelumnya untuk daftar bagian. Selain itu, dalam contoh ini, parameter `limit` diatur ke 1 dan mengembalikan satu bagian. Perhatikan bahwa bidang `Marker` bukan `null`, yang menunjukkan setidaknya ada satu bagian lagi yang harus didapatkan.
#### Contoh Permintaan
```
1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```
#### Contoh Respons
Sebagai tanggapan, Amazon Glacier menampilkan daftar bagian yang diunggah yang terkait dengan ID unggahan multibagian yang sedang berlangsung yang ditentukan.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Type: text/json
5. Content-Length: 412
6.
7. {
8. "ArchiveDescription" : "archive description 1",
9. "CreationDate" : "2012-03-20T17:03:43.221Z",
10. "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ",
11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
12. "PartSizeInBytes" : 4194304,
13. "Parts" :
14. [ {
15. "RangeInBytes" : "4194304-8388607",
16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
17. }],
18. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
19. }
```
## Bagian Terkait
+ [Memulai Unggahan Multipart (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Mengunggah Bagian (PUT UploadID)](api-upload-part.md)
+ [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)
+ [Mengunggah Arsip Besar dalam Beberapa Bagian (Unggahan Multipart)](uploading-archive-mpu.md)
+ [Identity and Access Management untuk Amazon Glacier](security-iam.md)
# Mencantumkan Unggahan Multipart (GET multipart-uploads)
## Deskripsi
Operasi unggahan multipart ini mencantumkan unggahan multiparti yang sedang berlangsung untuk vault yang ditentukan. Unggahan multipart yang sedang berlangsung adalah unggahan multipart yang telah dimulai menggunakan memulai permintaan [Memulai Unggahan Multipart (POST multipart-uploads)](api-multipart-initiate-upload.md), tetapi belum diselesaikan atau dihentikan. Daftar yang dikembalikan dalam respons Cantumkan Unggahan Multipart memiliki urutan tidak terjamin.
Operasi Cantumkan Unggahan Multipart mendukung pemberian nomor halaman. Secara default, operasi ini mengembalikan hingga 50 unggahan multipart dalam respons. Anda harus selalu memeriksa bidang `marker` dalam isi respons untuk penanda tempat untuk melanjutkan daftar; jika tidak ada lagi item, bidang `marker` adalah `null`.
Jika tidak null, untuk mengambil kumpulan unggahan multipart berikutnya, Anda mengirim permintaan Unggahan Multipart Daftar lainnya dengan parameter `marker` permintaan yang disetel ke nilai penanda Amazon Glacier (Amazon Glacier) yang dikembalikan sebagai tanggapan atas permintaan Unggahan Multipart Daftar sebelumnya. `marker`
Perhatikan perbedaan antara operasi ini dan operasi [Mencantumkan Bagian (GET uploadID)](api-multipart-list-parts.md)). Operasi Cantumkan Unggahan Multipart mencantumkan semua unggahan multipart untuk vault. Operasi Cantumkan Bagian mengembalikan bagian unggahan multiparti spesifik yang diidentifikasi oleh ID Unggah.
Untuk informasi tentang unggahan multipart, lihat [Mengunggah Arsip Besar dalam Beberapa Bagian (Unggahan Multipart)](uploading-archive-mpu.md).
## Permintaan
### Sintaksis
Untuk mencantumkan unggahan multipart, kirim permintaan `GET` ke URI dari subsumber daya `multipart-uploads` vault. Anda dapat secara opsional menentukan parameter `marker` dan `limit`.
```
1. GET /AccountId/vaults/VaultName/multipart-uploads HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. 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
| Nama | Deskripsi | Wajib |
| --- | --- | --- |
| limit | Menentukan jumlah maksimum unggahan yang dikembalikan dalam isi respons. Jika tidak ditentukan, operasi Cantumkan Daftar akan mengembalikan hingga 50 unggahan. Tipe: String Batasan: Nilai bilangan bulat minimum `1`. Nilai bilangan bulat maksimum `50`. | Tidak |
| marker | String buram yang digunakan untuk pemberian nomor halaman. `marker` menentukan unggahan tempat cantuman unggahan harus dimulai. Dapatkan nilai `marker` dari respons Cantumkan Unggahan sebelumnya. Anda hanya perlu menyertakan `marker` jika Anda melanjutkan pemberian nomor halaman dari hasil yang dimulai dalam permintaan Cantumkan Unggahan sebelumnya. Tipe: String Batasan: Tidak Ada | Tidak |
### Header Permintaan
Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat [Header Respons Umum](api-common-response-headers.md).
### Isi Permintaan
Operasi ini tidak memiliki isi permintaan.
## Respons
### Sintaksis
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Content-Type: application/json
5. Content-Length: Length
6.
7. {
8. "Marker": String,
9. "UploadsList" : [
10. {
11. "ArchiveDescription": String,
12. "CreationDate": String,
13. "MultipartUploadId": String,
14. "PartSizeInBytes": Number,
15. "VaultARN": String
16. },
17. ...
18. ]
19. }
```
### Header Respons
Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat [Header Respons Umum](api-common-response-headers.md).
### Isi Respons
Isi respons berisi bidang JSON berikut.
**ArchiveDescription**
Deskripsi arsip yang ditentukan dalam permintaan Mulai Unggahan Multipart. Bidang ini adalah `null` jika tidak ada deskripsi arsip yang ditentukan dalam operasi Mulai Unggahan Multipart.
*Tipe*: String
**CreationDate**
Waktu UTC unggahan multipart dimulai.
*Tipe*: String. Representasi string dalam format tanggal ISO 8601, misalnya `2013-03-20T17:03:43.221Z`.
**Penanda**
String buram yang mewakili tempat untuk melanjutkan pemberian nomor halaman hasil. Anda menggunakan `marker` dalam permintaan Cantumkan Unggahan Multipart baru untuk mendapatkan lebih banyak unggahan dalam daftar. Jika tidak ada lagi unggahan, nilai ini adalah `null`.
*Tipe*: String
**PartSizeInBytes**
Ukuran bagian yang ditentukan dalam permintaan [Memulai Unggahan Multipart (POST multipart-uploads)](api-multipart-initiate-upload.md). Ini adalah ukuran semua bagian dalam unggahan kecuali bagian terakhir, yang mungkin lebih kecil dari ukuran ini.
*Tipe*: Angka
**MultipartUploadId**
ID unggahan multipart.
*Tipe*: String
**UploadsList**
Daftar metadata tentang objek unggahan multipart. Setiap item dalam daftar berisi serangkaian pasangan nama nilai untuk unggahan yang sesuai, termasuk `ArchiveDescription`, `CreationDate`, `MultipartUploadId`, `PartSizeInBytes`, dan `VaultARN`.
*Tipe*: Array
**Vaultarn**
Amazon Resource Name (ARN) dari vault yang berisi arsip.
*Tipe*: String
### Kesalahan
Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, lihat. [Respons Kesalahan](api-error-responses.md)
## Contoh
### Contoh: Mencantumkan Semua Unggahan Multipart
Contoh berikut mencantumkan semua unggahan multipart yang sedang berlangsung untuk vault. Contoh ini menunjukkan permintaan `GET` HTTP ke URI dari subsumber daya `multipart-uploads` vault tertentu. Karena parameter `marker` dan `limit` tidak ditentukan dalam permintaan, hingga 1.000 unggahan multipart yang sedang berlangsung dikembalikan.
#### Contoh Permintaan
```
1. GET /-/vaults/examplevault/multipart-uploads HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```
#### Contoh Respons
Sebagai tanggapan Amazon Glacier mengembalikan daftar semua unggahan multipart yang sedang berlangsung untuk vault yang ditentukan. Bidang `marker` adalah `null`, yang menunjukkan tidak ada lagi unggahan ke daftar.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Type: application/json
5. Content-Length: 1054
6.
7. {
8. "Marker": null,
9. "UploadsList": [
10. {
11. "ArchiveDescription": "archive 1",
12. "CreationDate": "2012-03-19T23:20:59.130Z",
13. "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev",
14. "PartSizeInBytes": 4194304,
15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16. },
17. {
18. "ArchiveDescription": "archive 2",
19. "CreationDate": "2012-04-01T15:00:00.000Z",
20. "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
21. "PartSizeInBytes": 4194304,
22. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
23. },
24. {
25. "ArchiveDescription": "archive 3",
26. "CreationDate": "2012-03-20T17:03:43.221Z",
27. "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
28. "PartSizeInBytes": 4194304,
29. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
30. }
31. ]
32. }
```
### Contoh: Mencantumkan Bagian dari Unggahan Multipart
Contoh berikut menunjukkan cara menggunakan pemberian nomor halaman untuk mendapatkan sejumlah hasil terbatas. Contoh ini menunjukkan permintaan `GET` HTTP ke URI dari subsumber daya `multipart-uploads` untuk vault tertentu. Dalam contoh ini, parameter `limit` diatur ke 1, yang berarti hanya satu unggahan yang dikembalikan dalam daftar, dan parameter `marker` menunjukkan ID unggahan multipart tempat daftar yang dikembalikan dimulai.
#### Contoh Permintaan
```
1. GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```
#### Contoh Respons
Sebagai tanggapan, Amazon Glacier (Amazon Glacier) mengembalikan daftar tidak lebih dari dua unggahan multipart yang sedang berlangsung untuk vault yang ditentukan, dimulai dari penanda yang ditentukan dan menampilkan dua hasil.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Type: application/json
5. Content-Length: 470
6.
7. {
8. "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
9. "UploadsList" : [
10. {
11. "ArchiveDescription": "archive 2",
12. "CreationDate": "2012-04-01T15:00:00.000Z",
13. "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
14. "PartSizeInBytes": 4194304,
15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16. }
17. ]
18. }
```
## Bagian Terkait
+ [Memulai Unggahan Multipart (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Mengunggah Bagian (PUT UploadID)](api-upload-part.md)
+ [Menyelesaikan Unggahan Multipart (POST uploadID)](api-multipart-complete-upload.md)
+ [Membatalkan Unggahan Multipart (DELETE uploadID)](api-multipart-abort-upload.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)
# 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)