Amazon S3 Glacier
开发人员指南 (API 版本 2012-06-01)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

在 Amazon S3 Glacier 中处理文件库

文件库是用于存储档案的容器。在创建文件库时,您可以指定文件库名称以及您要在其中创建文件库的区域。有关支持的地区的列表,请参阅访问 Amazon S3 Glacier

您可以在文件库中存储无限多个档案。

重要

Amazon S3 Glacier (Glacier) 提供了一个管理控制台。您可以使用该控制台创建或删除文件库。但是,与 Glacier 的所有其他交互活动都要求您使用 AWS Command Line Interface (CLI) 或编写代码。例如,要上传照片、视频和其他文档等数据,您必须使用 AWS CLI 或编写代码发起请求(可直接利用 REST API 或使用 AWS 开发工具包)。有关如何通过 AWS CLI 使用 Glacier 的更多信息,请转到 Glacier 的 AWS CLI 参考。要安装 AWS CLI,请转到 AWS Command Line Interface

Glacier 中的文件库操作

Glacier 支持各种文件库操作。请注意,文件库操作是特定于地区的。例如,创建文件库时,您会在特定的地区创建。在您列出文件库时,Glacier 会从您在请求中指定的区域返回文件库列表。

创建和删除文件库

一个 AWS 账户最多可以为每个区域创建 1000 个文件库。有关 Glacier 支持的 AWS 区域的列表,请参阅 AWS 一般参考 中的区域和终端节点

仅当自 Glacier 计算的上次清单起文件库中没有任何档案,并且自上次清单盘点以来没有对文件库执行过任何写入操作时,您才能删除文件库。

注意

Glacier 每 24 小时会定期为每个文件库准备一份清单。由于清单可能没有反映最新信息,因此,Glacier 会通过检查自上次文件库清单盘点以来是否执行过任何写入操作来确保文件库确实是空的。

有关更多信息,请参阅 在 Amazon S3 Glacier 中创建文件库在 Amazon S3 Glacier 中删除文件库

取回文件库元数据

您可以取回文件库信息,例如,文件库创建日期、文件库中的档案数,以及文件库中所有档案的总大小。Glacier 提供了 API 调用,供您取回特定文件库或您账户中特定地区的所有文件库的此信息。有关更多信息,请参阅在 Amazon S3 Glacier 中检索文件库元数据

下载文件库清单

文件库清单指的是文件库中的档案列表。对于列表中的每个档案,库存均提供档案 ID、创建日期和大小等档案信息。自第一个档案上传到文件库之日起,Glacier 大约每天都会更新一次文件库清单。文件库清单必须存在,您才能下载它。

下载文件库清单是一种异步操作。您必须先启动下载库存的任务。收到任务请求后,Glacier 会为下载准备清单。任务完成后,您可以下载库存数据。

鉴于任务具有异步性,您可以使用 Amazon Simple Notification Service (Amazon SNS) 通知在任务完成时通知您。您可以为每个任务请求指定 Amazon SNS 主题,或者将您的文件库配置为在特定文件库事件发生时发送通知。

Glacier 每 24 小时会定期为每个文件库准备一份清单。如果在上次库存盘点后没有对文件库执行过添加或删除档案的操作,则不会更新库存日期。当您为文件库清单启动任务时,Glacier 返回其最近一次生成的清单,该清单是时间点快照,而不是实时数据。您可能没有发现为每个档案上传操作取回文件库清单有什么好处。但是,假设您在客户端维护数据库,且该客户端关联了您上传到 Glacier 的档案的元数据。此时,您可能会发现,文件库库存对于将您数据库中的信息与实际文件库库存进行协调很有用。

有关取回文件库清单的更多信息,请参阅“在 Amazon S3 Glacier 中下载文件库清单”。

配置文件库通知

从 Glacier 检索任何内容(例如文件库中的档案或文件库清单)都分为两步,在该过程中,第一步是启动任务。任务完成后,您可以下载输出。您可以使用 Glacier 通知支持来得知您的任务何时完成。Glacier 会将通知消息发送到您提供的 Amazon Simple Notification Service (Amazon SNS) 主题。

您可以配置文件库通知,并确定文件库事件以及要在事件发生时通知的 Amazon SNS 主题。每当有文件库事件发生时,Glacier 都会向指定的 Amazon SNS 主题发送通知。有关更多信息,请参阅在 Amazon S3 Glacier 中配置文件库通知