**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. # 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)