**此页面仅适用于使用文件库和 2012 年原始 REST API 的 Amazon Glacier 服务的现有客户。**
如果您正在寻找归档存储解决方案，建议使用 Amazon S3 中的 Amazon Glacier 存储类别 S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive。要了解有关这些存储选项的更多信息，请参阅 [Amazon Glacier 存储类别](https://aws.amazon.com/s3/storage-classes/glacier/)。
Amazon Glacier（最初基于保管库的独立服务）不再接受新客户。Amazon Glacier 是一项独立的服务 APIs ，拥有自己的服务，可将数据存储在文件库中，不同于亚马逊 S3 和 Amazon S3 Glacier 存储类别。在 Amazon Glacier 中，您现有的数据将确保安全，并且可以无限期地访问。无需进行迁移。对于低成本、长期的存档存储， AWS 建议[使用 Amazon S3 Glacier 存储类别，这些存储类别](https://aws.amazon.com/s3/storage-classes/glacier/)基于S3存储桶 APIs、完全 AWS 区域 可用性、更低的成本和 AWS 服务集成，可提供卓越的客户体验。如果您希望加强功能，可以考虑使用我们的 [AWS 将数据从 Amazon Glacier 文件库传输到 Amazon S3 Glacier 存储类别的解决方案指南](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)，迁移到 Amazon S3 Glacier 存储类别。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 列出分段上传（GET multipart-uploads）
## 说明
此分段上传操作会列出指定文件库中正在进行的分段上传。正在进行的分段上传是[启动分段上传（POST multipart-uploads）](api-multipart-initiate-upload.md)请求启动但尚未完成或停止的分段上传。在列出分段上传响应中返回的列表没有固定的顺序。
列出分段上传操作支持分页。默认情况下，此操作最多会在响应中返回 50 个分段上传。您应始终检查响应正文中的 `marker` 字段，以查看是否有继续该列表的标记；如果没有更多项目，则 `marker` 字段为 `null`。
如果 `marker` 不为 null，则为了获取下一组分段上传，您可以再发送一个列出分段上传请求，并将 `marker` 请求参数设置为 Amazon Glacier（Amazon Glacier）对上一次列出分段上传请求所回复的标记值。
请注意此操作与[列出段（GET uploadID）](api-multipart-list-parts.md)操作之间的区别。列出分段上传操作会列出文件库的所有分段上传。列出段操作会返回上传 ID 标识的特定分段上传的段。
有关分段上传的信息，请参阅[分段上传大型档案（分段上传）](uploading-archive-mpu.md)。
## 请求
### 语法
要列出分段上传，请向文件库的 `GET` 子资源的 URI 发送 `multipart-uploads` 请求。您可以选择性地指定 `marker` 和 `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
```
**注意**
该`AccountId`值是拥有文件库的账户的 AWS 账户 ID。您可以指定一个 AWS 账户 ID，也可以选择指定一个 '`-`'（连字符），在这种情况下，Amazon Glacier 使用与用于签署请求的凭证关联的 AWS 账户 ID。如果您使用账户 ID，请勿在 ID 中包含任何连字符（-）。
### 请求参数
| Name | 说明 | 必填 |
| --- | --- | --- |
| limit | 指定响应正文中返回的最大上传数。如果未指定，则列出上传操作最多会返回 50 个上传。 类型：字符串 约束：最小整数值为 `1`。最大整数值为 `50`。 | 否 |
| marker | 用于分页的不透明字符串。`marker` 指定应从其开始列出上传的上传。从之前的列出上传响应获取 `marker` 值。只有在您要继续对之前的列出上传请求中开始的结果进行分页，您才需要包括 `marker`。 类型：字符串 约束：无 | 否 |
### 请求标头
此操作仅使用大多数响应通用的响应标头。有关通用响应标头的信息，请参阅[通用响应标头](api-common-response-headers.md)。
### 请求正文
此操作没有请求正文。
## 响应
### 语法
```
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. }
```
### 响应标头
此操作仅使用大多数响应通用的响应标头。有关通用响应标头的信息，请参阅[通用响应标头](api-common-response-headers.md)。
### 响应正文
响应正文包含以下 JSON 字段。
**ArchiveDescription**
在启动分段上传请求中指定的档案描述。如果在启动分段上传操作中没有指定档案描述，则此字段为 `null`。
*类型*：字符串
**CreationDate**
分段上传启动的 UTC 时间。
*类型*：字符串。以 ISO 8601 日期格式表示的字符串，例如 `2013-03-20T17:03:43.221Z`。
**Marker**
表示从何处继续对结果进行分页的不透明字符串。您可以在新的列出分段上传请求中使用 `marker` 来获取列表中的更多上传。如果没有更多上传，则此值为 `null`。
*类型*：字符串
**PartSizeInBytes**
在[启动分段上传（POST multipart-uploads）](api-multipart-initiate-upload.md)请求中指定的段大小。这是上传中除了最后一段以外的所有段的大小，最后一段可能小于此大小。
*类型*：数字
**MultipartUploadId**
分段上传的 ID。
*类型*：字符串
**UploadsList**
有关分段上传数据元的元数据的列表。列表中的每个项目均包含相应上传的一组名称-值对，包括 `ArchiveDescription`、`CreationDate`、`MultipartUploadId`、`PartSizeInBytes` 和 `VaultARN`。
*类型*：数组
**VaultARN**
包含档案的文件库的 Amazon 资源名称（ARN）。
*类型*：字符串
### 错误
有关 Amazon Glacier 异常和错误消息的信息，请参阅[错误响应](api-error-responses.md)。
## 示例
### 示例：列出所有分段上传
以下示例列出了文件库的正在进行的所有分段上传。该示例显示了发送到指定文件库的 `GET` 子资源 URI 的 HTTP `multipart-uploads` 请求。由于请求中没有指定 `marker` 和 `limit` 参数，因此，系统最多会返回 1000 个正在进行的分段上传。
#### 请求示例
```
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
```
#### 响应示例
在响应中，Amazon Glacier 返回指定文件库所有正在进行的分段上传的列表。`marker` 字段为 `null`，表示没有更多上传要列出。
```
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. }
```
### 示例：分段上传的部分列表
以下示例展示了如何使用分页来获取有限数量的结果。该示例显示了发送到指定文件库的 `GET` 子资源 URI 的 HTTP `multipart-uploads` 请求。在此示例中，`limit` 参数设置为 1，这意味着只在列表中返回一个上传，而 `marker` 参数则表示返回的列表从其开始的分段上传 ID。
#### 请求示例
```
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
```
#### 响应示例
在响应中，Amazon Glacier（Amazon Glacier）只返回指定文件库的最多两个正在进行的分段上传，从指定的标记开始返回两个结果。
```
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. }
```
## 相关部分
+ [启动分段上传（POST multipart-uploads）](api-multipart-initiate-upload.md)
+ [上传段（PUT uploadID）](api-upload-part.md)
+ [完成分段上传（POST uploadID）](api-multipart-complete-upload.md)
+ [中止分段上传（DELETE uploadID）](api-multipart-abort-upload.md)
+ [列出段（GET uploadID）](api-multipart-list-parts.md)
+ [分段上传大型档案（分段上传）](uploading-archive-mpu.md)
+ [适用于 Amazon Glacier 的 Identity and Access Management](security-iam.md)