此页面仅适用于使用 Vaults 和 2012 年原始 REST API 的 Amazon Glacier 服务的现有客户。
如果您正在寻找档案存储解决方案，我们建议您在亚马逊 S3、S3 Glacier 即时检索、S3 Glacier 灵活检索和 S3 Glacier Deep Archive Deep Archive 中使用 Amazon Glacier 存储类。要了解有关这些存储选项的更多信息，请参阅 Amazon Glacier 存储类别
从 2025 年 12 月 15 日起，Amazon Glacier（最初基于保管库的独立服务）将不再接受新客户，对现有客户不产生任何影响。Amazon Glacier 是一项独立的服务 APIs ，拥有自己的服务，可将数据存储在文件库中，不同于亚马逊 S3 和 Amazon S3 Glacier 存储类别。在 Amazon Glacier 中，您的现有数据将保持安全且可以无限期地访问。无需迁移。对于低成本、长期的存档存储， AWS 建议使用 Amazon S3 Glacier 存储类别，这些存储类别
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
在 Amazon Glacier 中使用文件库
文件库是用于存储存档的容器。创建文件库时，需要指定文件库名称和要 AWS 区域 在其中创建文件库。有关 Amazon Glacier AWS 区域 支持的终端节点列表，请参阅AWS 一般参考中的亚马逊 Glacier 终端节点和配额。
您可以在文件库中存储无限多个档案。
重要
Amazon Glacier 确实提供了控制台。但是，任何存档操作（例如上传、下载或删除）都需要您使用 AWS Command Line Interface (AWS CLI) 或编写代码。存档操作没有控制台支持。例如，要上传数据（例如照片、视频和其他文档），您必须使用 AWS CLI 或编写代码来发出请求，方法是直接使用 REST API 或使用 AWS SDKs。
要安装 AWS CLI，请参阅AWS Command Line Interface
主题
亚马逊 Glacier 中的保管库操作
Amazon Glacier 支持各种文件库操作。文件库操作取决于特定 AWS 区域。换而言之，创建文件库时，您在特定 AWS 区域中创建。当您列出文件库时，Amazon Glacier 会 AWS 区域 返回您在请求中指定的文件库列表。
创建和删除文件库
每个文件库最多 AWS 账户 可以创建 1,000 个。 AWS 区域有关 Amazon Glacier AWS 区域 支持的终端节点列表，请参阅AWS 一般参考中的亚马逊 Glacier 终端节点和配额。
只有在 Amazon Glacier 计算的上次库存时，文件库中没有任何档案，并且自上次盘点以来没有对文件库进行过写入时，您才能删除该文件库。
注意
Amazon Glacier 每 24 小时会定期为每个文件库准备一份库存。由于库存可能无法反映最新信息，因此 Amazon Glacier 会通过检查自上次文件库盘点以来是否有任何写入操作来确保文件库确实为空。
有关更多信息，请参阅在 Amazon Glacier 中创建文件库和在 Amazon Glacier 中删除文件库。
检索文件库元数据
您可以检索文件库信息，例如文件库的创建日期、文件库中的档案数，以及文件库中所有档案的总大小。Amazon Glacier 提供 API 调用，供您检索账户中特定文件库或特定文件库中所有文件库 AWS 区域 的此信息。有关更多信息，请参阅 在 Amazon Glacier 中检索文件库元数据。
下载文件库清单
文件库清单指的是文件库中的档案列表。对于列表中的每个档案，清单都提供了档案信息，例如档案 ID、创建日期和大小。从第一个档案上传到文件库之日起，Amazon Glacier 每天更新一次文件库库存。文件库清单必须存在，您才能下载它。
下载文件库清单是一种异步操作。您必须先启动下载清单的任务。收到任务请求后，Amazon Glacier 会准备您的库存以供下载。任务完成后，您可以下载清单数据。
鉴于任务具有异步性，您可以使用 Amazon Simple Notification Service (Amazon SNS) 通知在任务完成时通知您。您可以为每个任务请求指定 Amazon SNS 主题，或者将您的文件库配置为在特定文件库事件发生时发送通知。
Amazon Glacier 每 24 小时会定期为每个文件库准备一份库存。如果在上次清单盘点后没有对文件库执行过添加或删除档案的操作，则不会更新库存日期。
当您启动文件库库存任务时，Amazon Glacier 会返回其生成的最后一个清单，即 point-in-time快照而不是实时数据。您可能没有发现为每个档案上传操作检索文件库清单有什么好处。但是，假设您在客户端维护一个数据库，其中包含与您上传到 Amazon Glacier 的档案相关的元数据。此时，您可能会发现，文件库清单存对于将您数据库中的信息与实际文件库清单进行协调很有用。
有关检索文件库清单的更多信息，请参阅在 Amazon Glacier 中下载文件库清单。
配置文件库通知
从 Amazon Glacier 检索任何内容（例如文件库中的档案或文件库库存）需要分为两个步骤。首先，启动一项任务。任务完成后，下载输出。要了解您的任务何时完成，您可以使用 Amazon Glacier 通知。Amazon Glacier 会向您提供的亚马逊简单通知服务 (Amazon SNS) Simple Notification Service 主题发送通知消息。
您可以配置文件库通知，并确定文件库事件以及要在事件发生时通知的 Amazon SNS 主题。每当文件库事件发生时，Amazon Glacier 都会向指定的亚马逊 SNS 主题发送通知。有关更多信息，请参阅 在 Amazon Glacier 中配置文件库通知。
