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

在 Amazon Glacier 中处理文件库

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

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

重要

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

Amazon Glacier 中的文件库操作

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

创建和删除文件库

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

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

注意

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

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

取回文件库元数据

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

下载文件库清单

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

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

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

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

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

配置文件库通知

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

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