在 Amazon Glacier 中下载文件库清单 - Amazon Glacier
关于库存
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

此页面仅适用于使用 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 中，您的现有数据将保持安全且可以无限期地访问。无需迁移。对于低成本、长期的存档存储， Amazon 建议使用 Amazon S3 Glacier 存储类别，这些存储类别基于S3存储桶 APIs、完全 Amazon Web Services 区域 可用性、更低的成本和 Amazon 服务集成，可提供卓越的客户体验。如果您想要增强功能，可以考虑使用我们的Amazon 解决方案指南迁移到 Amazon S3 Glacier 存储类别，将数据从 Amazon Glacier 文件库传输到 Amazon S3 Glacier 存储类。

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

在 Amazon Glacier 中下载文件库清单

将第一个档案上传到文件库后，Amazon Glacier（Amazon Glacier）会自动创建文件库清单，然后大约每天更新一次。在 Amazon Glacier 创建第一份库存后，通常需要半天至多一天的时间才能让该库存可供取回。您可以通过以下两步流程从 Amazon Glacier 取回文件库库存：

  1. 使用 启动作业（POST 作业） 操作启动清单检索任务。

    重要

    数据检索策略可能导致您启动检索作业的请求失败，并发生 PolicyEnforcedException 异常。有关数据检索策略的更多信息，请参阅亚马逊 Glacier 数据检索政策。有关 PolicyEnforcedException 异常的更多信息，请参阅错误响应。

  2. 在任务完成后，使用 获取任务输出（获取输出） 操作下载字节。

例如，检索档案或文件库清单的操作要求您首先启动检索任务。任务请求会异步运行。当您启动取回任务时，Amazon Glacier 会创建一个任务并在响应中返回任务 ID。当 Amazon Glacier 完成任务后，您可以获取任务输出、档案字节或文件库库存数据。

任务必须先完成，然后，您才能获取其输出。要确定任务的状态，您有以下选择：

  • 等待任务完成通知-您可以指定一个亚马逊简单通知服务 (Amazon SNS) Simple Notification Service 主题，任务完成后，Amazon Glacier 可以向该主题发布通知。您可以使用以下方法指定 Amazon SNS 主题：

    • 为每个任务指定 Amazon SNS 主题。

      启动任务时，您可以选择性地指定 Amazon SNS 主题。

    • 设置文件库的通知配置。

      您可以设置文件库的特定事件的通知配置（参阅在 Amazon Glacier 中配置文件库通知）。每当特定事件发生时，Amazon Glacier 都会向指定的 SNS 主题发送一条消息。

    如果您在文件库中设置了通知配置，并且在启动任务时还指定了 Amazon SNS 主题，则 Amazon Glacier 会向这两个主题发送任务完成消息。

    您可以将 SNS 主题配置为通过电子邮件通知您或者将消息存储在应用程序可以轮询的 Amazon Simple Queue Service (Amazon SQS) 中。当该队列中出现消息时，您可以检查任务是否已成功完成，然后下载任务输出。

  • 明确请求任务信息 — Amazon Glacier 还提供了描述任务操作 (描述任务（获取任务 ID）)，使您可以通过轮询获取任务信息。您可以定期发送此请求，以获取任务信息。但是，使用 Amazon SNS 通知才是推荐的选择。

注意

您通过 SNS 通知获取的信息与通过调用描述任务获取的信息相同。

主题

关于库存

从您首次向文件库上传档案的那一天起，Amazon Glacier 每天至少更新一次文件库库存。如果在上次清单盘点后没有对文件库执行过添加或删除档案的操作，则不会更新库存日期。当您启动文件库库存任务时，Amazon Glacier 会返回其生成的最后一个库存，即 point-in-time快照而不是实时数据。请注意，在 Amazon Glacier 为文件库创建第一份库存后，通常需要半天至多一天的时间才能让该库存可供取回。

您可能没有发现为每个档案上传操作检索文件库清单有什么好处。但是，假设您在客户端维护一个数据库，关联您上传到 Amazon Glacier 的档案的元数据。此时，您可能会发现，文件库库存对于根据需要将您数据库中的信息与实际文件库库存进行协调很有用。您可以通过筛选存档创建日期或设置配额，来限制检索的清单项目数。有关限制清单检索的更多信息，请参阅确定清单检索范围。

清单可以按两种格式 (逗号分隔值 (CSV) 或 JSON) 返回。启动清单任务时，您可以选择性地指定格式。默认格式为 JSON。有关清单任务输出中返回的数据字段的更多信息，请参阅“获取任务输出 API”的响应正文。