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