在 Amazon S3 Glacier 中处理文件库 - Amazon S3 Glacier
S3 Glacier 中的文件库操作
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

此页面仅适用于使用保管库的 S3 Glacier 服务的现有客户以及 2012 年以RESTAPI来的原始客户。

如果您正在寻找档案存储解决方案，我们建议您在亚马逊 S3、S3 Glacier 即时检索、S3 Glacier 灵活检索和 S3 Glacier Deep Archive Dee p Archive 中使用 S3 Glacier 存储类。要了解有关这些存储选项的更多信息，请参阅 Amazon S3 用户指南中的 S3 Glacier 存储类和使用 S3 Glacier 存储类的长期数据存储。这些存储类别使用 Amazon S3API，适用于所有区域，并且可以在 Amazon S3 控制台中进行管理。它们提供存储成本分析、存储镜头、高级可选加密功能等功能。

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

在 Amazon S3 Glacier 中处理文件库

文件库是用于存储档案的容器。在创建文件库时，您可以指定文件库名称以及您要在其中创建文件库的 Amazon Web Services 区域。有关 S3 Glacier 支持的 Amazon Web Services 区域列表，请参阅《Amazon 一般参考》中的 Amazon S3 Glacier 端点和配额。

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

重要

S3 Glacier 确实提供了一个控制台。但任何归档操作（例如上传、下载或删除）均要求您使用 Amazon Command Line Interface (Amazon CLI) 或编写代码。归档操作没有控制台支持。例如，要上传照片、视频和其他文档等数据，您必须使用 Amazon CLI 或编写代码发起请求（可直接利用 REST API 或使用 Amazon SDK）。

要安装 Amazon CLI，请参阅 Amazon Command Line Interface。有关将 S3 Glacier 与 Amazon CLI 配合使用的更多信息，请参阅 S3 Glacier 的 Amazon CLI 参考。有关使用 Amazon CLI 将档案上传到 S3 Glacier 的示例，请参阅结合使用 S3 Glacier 与 Amazon Command Line Interface。

主题

S3 Glacier 中的文件库操作

S3 Glacier 支持各种文件库操作。文件库操作取决于特定 Amazon Web Services 区域。换而言之，创建文件库时，您在特定 Amazon Web Services 区域中创建。在您列出文件库时，S3 Glacier 会从您在请求中指定的 Amazon Web Services 区域返回文件库列表。

创建和删除文件库

Amazon Web Services 账户 最多可以为每个 Amazon Web Services 区域创建 1000 个文件库。有关 S3 Glacier 支持的 Amazon Web Services 区域列表，请参阅《Amazon 一般参考》中的 Amazon S3 Glacier 端点和配额。

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

注意

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

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

检索文件库元数据

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

下载文件库清单

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

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

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

S3 Glacier 每 24 小时会定期为每个文件库准备一份清单。如果在上次清单盘点后没有对文件库执行过添加或删除档案的操作，则不会更新库存日期。

当您为文件库清单启动任务时，S3 Glacier 返回其最近一次生成的清单，该清单是时间点快照，而不是实时数据。您可能没有发现为每个档案上传操作检索文件库清单有什么好处。但是，假设您在客户端维护数据库，且该数据库中包含与您上传到 S3 Glacier 的档案关联的元数据。此时，您可能会发现，文件库清单存对于将您数据库中的信息与实际文件库清单进行协调很有用。

有关检索文件库清单的更多信息，请参阅在 Amazon S3 Glacier 中下载文件库清单。

配置文件库通知

从 S3 Glacier 检索任何内容（例如文件库中的档案或文件库清单）是一个分为两步的过程。首先，启动一项任务。任务完成后，下载输出。要了解您的任务何时完成，您可以使用 S3 Glacier 通知。S3 Glacier 会将通知消息发送到您提供的 Amazon Simple Notification Service (Amazon SNS) 主题。

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