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