

 **此页面仅适用于使用文件库和 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 存储类别。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Amazon Glacier 的 API 参考
<a name="amazon-glacier-api"></a>

Amazon Glacier 支持一系列操作，特别是一组用于与服务交互的 RESTful API 调用。

您可以使用能够发送 HTTP 请求的任何编程库，将您的 REST 请求发送到 Amazon Glacier。发送 REST 请求时，Amazon Glacier 会要求您通过对请求签名来验证每个请求。此外，上传档案时，您还必须计算有效载荷的校验和，并将它包括在您的请求中。有关更多信息，请参阅[对请求进行签名](amazon-glacier-signing-requests.md)。

如果发生错误，您需要知道 Amazon Glacier 在错误响应中发送的内容，以便进行处理。除了介绍 REST 操作以外，此部分还提供了所有的此类信息，以便您直接进行 REST API 调用。

您可以直接使用 REST API 调用或者使用 Amazon SDK，这些 SDK 提供了包装程序库。这些库会对您发送的每个请求签名，并对您请求中的有效载荷计算校验和。因此，使用 Amazon SDK 可以简化您的编码任务。此开发人员指南通过实际案例举例说明使用适用于 Java 的 Amazon SDK 和 .NET 的基本 Amazon Glacier 操作。有关更多信息，请参阅[Amazon SDKs 与 Amazon Glacier 搭配使用](using-aws-sdk.md)。

**Topics**
+ [通用请求标头](api-common-request-headers.md)
+ [通用响应标头](api-common-response-headers.md)
+ [对请求进行签名](amazon-glacier-signing-requests.md)
+ [计算校验和](checksum-calculations.md)
+ [错误响应](api-error-responses.md)
+ [文件库操作](vault-operations.md)
+ [档案操作](archive-operations.md)
+ [分段上传操作](multipart-archive-operations.md)
+ [任务操作](job-operations.md)
+ [在任务操作中使用的数据类型](api-data-types.md)
+ [数据检索操作](data-retrieval-policy-operations.md)