在 Amazon AWS S3 Glacier 上使用软件开发工具包 - Amazon S3 Glacier

如果您不熟悉 Amazon Simple Storage Service (Amazon S3) 中的归档存储功能,建议您先详细了解 Amazon S3 中的 S3 Glacier 存储类、S3 Glacier 即时检索S3 Glacier 灵活检索S3 Glacier 深度归档。有关更多信息,请参阅 Amazon S3 用户指南中的 S3 Glacier 存储类和用于存档对象的存储类。

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

在 Amazon AWS S3 Glacier 上使用软件开发工具包

AWS 提供软件开发工具包供您为 Amazon S3 Glacier 开发应用程序。SDK 库包含底层 S3 Glacier API,可以简化您的编程任务。例如,对于发送到 S3 Glacier 的每个请求,必须包括签名才能验证您的请求。使用 SDK 库时,您只需要在代码中提供 AWS 安全证书,库会计算必要的签名并将其包含在发送到 S3 Glacier 的请求中。这些 AWS 软件开发工具包提供了映射到底层 REST API 的库,并提供了可用于轻松构造请求和处理响应的对象。

AWS Command Line Interface (AWS CLI) 是一款用于管理您 AWS 服务的(包括 S3 Glacier)的统一工具。有关下载的信息 AWS CLI,请参阅AWS Command Line Interface。有关 S3 Glacier CLI 命令的列表,请参阅《AWS CLI 命令参考》https://docs.aws.amazon.com/cli/latest/reference/glacier/index.html

AWS Java 和.NET 的 SDK 库

适用于 Java 和.NET 的 AWS 软件开发工具包提供高级和低级封装库。

您可以使用本开发者指南中的 AWS SDK for Java 和来查找使用 Amazon S3 Glacier 的 AWS SDK for .NET 示例。

什么是低级 API?

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

有关这些软件开发工具包库的信息,请参阅将 AWS SDK for Java 与 Amazon S3 Glacier 结合使用将 AWS SDK for .NET 与 Amazon S3 Glacier 结合使用

什么是高级 API?

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

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

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

有关这些软件开发工具包库的信息,请参阅将 AWS SDK for Java 与 Amazon S3 Glacier 结合使用将 AWS SDK for .NET 与 Amazon S3 Glacier 结合使用

何时使用高级和低级 API?

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