将 Amazon SDK 与 Amazon Glacier 结合使用 - Amazon Glacier
适用于 Java 和 .NET 的 Amazon SDK
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

此页面仅适用于使用文件库和 2012 年原始 REST API 的 Amazon Glacier 服务的现有客户。

如果您正在寻找归档存储解决方案，建议使用 Amazon S3 中的 Amazon Glacier 存储类别 S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive。要了解有关这些存储选项的更多信息，请参阅 Amazon Glacier 存储类别。

从 2025 年 12 月 15 日起，Amazon Glacier（最初基于独立文件库的服务）将不再接受新客户，对现有客户不存在任何影响。Amazon Glacier 是一项独立服务，拥有自己的 API，可将数据存储在文件库中，与 Amazon S3 和 Amazon S3 Glacier 存储类别不同。在 Amazon Glacier 中，您现有的数据将确保安全，并且可以无限期地访问。无需进行迁移。对于低成本、长期的存档存储，Amazon 建议使用 Amazon S3 Glacier 存储类别，该类别可通过基于 S3 存储桶的 API、完全的 Amazon Web Services 区域可用性、更低的成本和 Amazon 服务集成，提供卓越的客户体验。如果您希望加强功能，可以考虑使用我们的 Amazon 将数据从 Amazon Glacier 文件库传输到 Amazon S3 Glacier 存储类别的解决方案指南，迁移到 Amazon S3 Glacier 存储类别。

将 Amazon SDK 与 Amazon Glacier 结合使用

Amazon 提供一些 SDK，助您开发 Amazon Glacier 应用程序。SDK 库包含底层 Amazon Glacier API，可以简化您的编程任务。例如，对于发送到 Amazon Glacier 的每个请求，必须包括签名才能验证您的请求。在使用 SDK 库时，您只需在代码中提供 Amazon 安全凭证，库会计算所需的签名并将其包括在发送到 Amazon Glacier 的请求中。Amazon SDK 提供了可映射到底层 REST API 的库，以及可让您轻松构建请求并处理响应的数据元。

主题

Amazon Command Line Interface（Amazon CLI）是用于管理您的 Amazon Web Services 服务（包括 Amazon Glacier）的统一工具。有关下载 Amazon CLI 的信息，请参阅 Amazon Command Line Interface。有关 Amazon Glacier CLI 命令的列表，请参阅 Amazon CLI 命令参考。

适用于 Java 和 .NET 的 Amazon SDK

适用于 Java 和 .NET 的 Amazon SDK 提供了高级和低级包装程序库。

在整个开发人员指南中，您可以查找通过适用于 Java 的 Amazon SDK 和适用于 .NET 的 Amazon SDK 使用 Amazon Glacier 的示例。

什么是低级 API？

低级包装程序库紧密映射 Amazon Glacier 支持的底层 REST API（Amazon Glacier 的 API 参考）。对于每个 Amazon Glacier REST 操作，低级 API 均提供了相应的方法、用于提供请求信息的请求对象，以及用于处理 Amazon Glacier 响应的响应对象。低级包装程序库是底层 Amazon Glacier 操作的最完整实现。

有关这些软件开发工具包库的信息，请参阅将适用于 Java 的 Amazon SDK 与 Amazon Glacier 结合使用和将适用于 .NET 的 Amazon SDK 与 Amazon Glacier 结合使用。

什么是高级 API？

为了进一步简化应用程序开发，这些库为某些操作提供了更高级的抽象。例如：

  • 上传档案—要使用低级 API 上传档案，则除了文件名以及您要在其中保存档案的文件库名称以外，您还需要提供有效载荷的校验和（SHA-256 树形哈希）。但是，高级 API 会为您计算校验和。

  • 下载档案或文件库清单—要使用低级 API 下载档案，您首先要启动任务，等待任务完成，然后获取任务输出。您需要编写附加代码来设置 Amazon Simple Notification Service（Amazon SNS）主题，以便 Amazon Glacier 在作业完成时通知您。此外，您还需要使用某个轮询机制来检查任务完成消息是否已发布到该主题。该高级 API 提供了用于下载档案的方法，该方法会处理所有的这些步骤。您只需指定档案 ID 以及您要保存下载的数据的文件夹路径。

有关这些软件开发工具包库的信息，请参阅将适用于 Java 的 Amazon SDK 与 Amazon Glacier 结合使用和将适用于 .NET 的 Amazon SDK 与 Amazon Glacier 结合使用。

何时使用高级和低级 API？

通常，如果高级 API 提供了您执行操作所需的方法，则您应使用高级 API，因为这样比较简单。但是，如果高级 API 没有提供该功能，则您可以使用低级 API。此外，低级 API 还允许对操作进行粒度控制（例如，在操作失败时执行重试逻辑）。例如，上传档案时，高级 API 会使用文件大小来确定是在单个操作中上传档案，还是使用分段上传 API。此外，该 API 还具有内置的重试逻辑，可以在上传失败时执行。但是，您的应用程序可能需要对这些决定进行粒度控制，在这种情况下，您可以使用低级 API。