亚马逊 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 存储类。

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

亚马逊 Glacier 数据模型

Amazon Glacier 数据模型的核心组件包括文件库和档案。Amazon Glacier 是一项基于 REST 的网络服务。根据 REST，文件库和档案是资源。此外，Amazon Glacier 数据模型还包括任务和通知配置资源。这些资源是对核心资源的补充。

文件库

在 Amazon Glacier 中，文件库是用于存储档案的容器。文件库与 Amazon S3 存储桶类似。创建文件库时，需要指定名称并选择要在 Amazon Web Services 区域 何处创建文件库。

每个文件库资源都有唯一的地址。一般格式为：

https://region-specific-endpoint/account-id/vaults/vault-name

例如，假设您使用 ID 为 111122223333 的账户在美国西部（俄勒冈州）区域创建一个文件库 (examplevault)。那么，您可以使用以下 URI 为此文件库编址：

https://glacier.us-west-2.amazonaws.com/111122223333/vaults/examplevault

以下是 URI 的各个组成部分的含义：

  • glacier.us-west-2.amazonaws.com 标识美国西部（俄勒冈州）区域。

  • 111122223333是拥有文件库的 Amazon Web Services 账户 ID。

  • vaults 是指 Amazon Web Services 账户拥有的文件库集合。

  • examplevault 标识了文件库集合中的特定文件库。

Amazon Web Services 账户 可以在任何支持的 Amazon Web Services 区域存储库中创建文件库。有关支持的列表 Amazon Web Services 区域，请参阅访问亚马逊 Glacier。在一个区域内，一个账户必须使用唯一的文件库名称。 Amazon Web Services 账户 可以在不同的区域创建同名文件库。

您可以在文件库中存储无限多个档案。根据您的业务或应用程序需求，您可以将这些档案存储在一个或多个文件库中。

Amazon Glacier 支持各种文件库操作。文件库操作是特定于区域的。例如，创建文件库时，您会在特定的区域创建。当您请求文件库列表时，您需要从特定区域请求文件库 Amazon Web Services 区域，结果列表仅包含在该特定区域创建的文件库。

档案

档案 可以是任何数据，例如照片、视频或文档。档案类似于 Amazon S3 对象，是 Amazon Glacier 的基本存储单元。每个档案都有唯一的 ID 和可选的描述。您只能在上传档案时指定此可选描述。Amazon Glacier 会为档案分配一个 ID，该编号 Amazon Web Services 区域 在存储档案时是唯一的。

每个档案都有唯一的地址。一般格式如下：

https://region-specific-endpoint/account-id/vaults/vault-name/archives/archive-id

以下是存储在美国西部（俄勒冈州）区域中账户 111122223333 下的 examplevault 文件库中的档案的示例 URI：

https://glacier.us-west-2.amazonaws.com/111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId

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

作业

Amazon Glacier 任务可以取回档案，也可以获取文件库的清单。

在 Amazon Glacier 中，检索档案和文件库清单（档案清单）是 Amazon Glacier 中的异步操作，在该操作中，您首先启动任务，然后在 Amazon Glacier 完成任务后下载任务输出。

注意

Amazon Glacier 提供冷存储数据存档解决方案。如果您的应用程序需要一套要求进行实时数据检索的存储解决方案，则可以考虑使用 Amazon S3。有关更多信息，请参阅 Amazon Simple Storage Service (Amazon S3)。

要启动文件库清单任务，您需要提供文件库名称。档案检索任务需要文件库名称和档案 ID。您还可以提供可选的任务描述来帮助标识任务。

档案检索和文件库清单任务与文件库相关联。在任何时间点，一个文件库可以同时进行多个任务。当您发送任务请求（启动任务）时，Amazon Glacier 会向您返回任务编号以跟踪任务。每个任务都会由以下格式的 URI 唯一标识：

https://region-specific-endpoint/account-id/vaults/vault-name/jobs/job-id

以下是与美国西部（俄勒冈州）区域中账户 111122223333 下的 examplevault 文件库关联的任务示例。

https://glacier.us-west-2.amazonaws.com/111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID

Amazon Glacier 会为每项任务保留信息，例如任务类型、描述、创建日期、完成日期和任务状态。您可以获取有关特定任务的信息，也可以获取与某个文件库相关联的所有任务的列表。Amazon Glacier 返回的任务列表包括所有正在进行和最近完成的任务。

通知配置

由于任务需要时间才能运行，因此 Amazon Glacier 支持一种通知机制，可在任务完成时通知您。您可以将文件库配置为在任务完成时向 Amazon Simple Notification Service (Amazon SNS) 主题发送通知。您可以在通知配置中为每个文件库指定一个 Amazon SNS 主题。

Amazon Glacier 将通知配置存储为 JSON 文档。以下是文件库通知配置示例：

{
   "Topic": "arn:aws:sns:us-west-2:111122223333:mytopic", 
   "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"] 
}

通知配置与文件库相关联；每个文件库都可以有一个通知配置。每个通知配置资源都会由以下格式的 URI 唯一标识：

https://region-specific-endpoint/account-id/vaults/vault-name/notification-configuration

Amazon Glacier 支持设置、获取和删除通知配置的操作。如果您删除了通知配置，则针对该文件库的任何数据检索操作完成时，系统都不会发送任何通知。