**此页面仅适用于使用文件库和 2012 年原始 REST API 的 Amazon Glacier 服务的现有客户。**
如果您正在寻找归档存储解决方案，建议使用 Amazon S3 中的 Amazon Glacier 存储类别 S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive。要了解有关这些存储选项的更多信息，请参阅 [Amazon Glacier 存储类别](https://aws.amazon.com/s3/storage-classes/glacier/)。
Amazon Glacier（最初基于保管库的独立服务）不再接受新客户。Amazon Glacier 是一项独立的服务 APIs ，拥有自己的服务，可将数据存储在文件库中，不同于亚马逊 S3 和 Amazon S3 Glacier 存储类别。在 Amazon Glacier 中，您现有的数据将确保安全，并且可以无限期地访问。无需进行迁移。对于低成本、长期的存档存储， AWS 建议[使用 Amazon S3 Glacier 存储类别，这些存储类别](https://aws.amazon.com/s3/storage-classes/glacier/)基于S3存储桶 APIs、完全 AWS 区域 可用性、更低的成本和 AWS 服务集成，可提供卓越的客户体验。如果您希望加强功能，可以考虑使用我们的 [AWS 将数据从 Amazon Glacier 文件库传输到 Amazon S3 Glacier 存储类别的解决方案指南](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)，迁移到 Amazon S3 Glacier 存储类别。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# Amazon Glacier 数据模型
Amazon Glacier 数据模型核心组件包括文件库和档案。Amazon Glacier 是一项基于 REST 的 Web 服务。根据 REST，文件库和档案是资源。此外，Amazon Glacier 数据模型还包括任务和通知配置资源。这些资源是对核心资源的补充。
**Topics**
+ [文件库](#data-model-vault)
+ [档案](#data-model-archive)
+ [任务](#data-model-job)
+ [通知配置](#data-model-notification-config)
## 文件库
在 Amazon Glacier 中，*文件库*是用于存储档案的容器。文件库与 Amazon S3 存储桶类似。创建文件库时，需要指定名称并选择要在 AWS 区域 何处创建文件库。
每个文件库资源都有唯一的地址。一般格式为：
```
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`是拥有文件库的 AWS 账户 ID。
+ `vaults` 是指 AWS 账户拥有的文件库集合。
+ `examplevault` 标识了文件库集合中的特定文件库。
AWS 账户 可以在任何支持的 AWS 区域存储库中创建文件库。有关支持的列表 AWS 区域，请参阅[访问 Amazon Glacier](amazon-glacier-accessing.md)。在一个区域内，一个账户必须使用唯一的文件库名称。 AWS 账户 可以在不同的区域创建同名文件库。
您可以在文件库中存储无限多个档案。根据您的业务或应用程序需求，您可以将这些档案存储在一个或多个文件库中。
Amazon Glacier 支持各种文件库操作。文件库操作是特定于区域的。例如，创建文件库时，您会在特定的区域创建。当您请求文件库列表时，您需要从特定区域请求文件库 AWS 区域，结果列表仅包含在该特定区域创建的文件库。
## 档案
*档案* 可以是任何数据，例如照片、视频或文档。档案与 Amazon S3 对象类似，是 Amazon Glacier 中的基本存储单位。每个档案都有唯一的 ID 和可选的描述。您只能在上传档案时指定此可选描述。Amazon Glacier 会为档案分配一个 ID，该编号 AWS 区域 在存储档案时是唯一的。
每个档案都有唯一的地址。一般格式如下：
```
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 S3。有关更多信息，请参阅 [Amazon Simple Storage Service（Amazon S3）](https://aws.amazon.com/s3)。
要启动文件库清单任务，您需要提供文件库名称。档案检索任务需要文件库名称和档案 ID。您还可以提供可选的任务描述来帮助标识任务。
档案检索和文件库清单任务与文件库相关联。在任何时间点，一个文件库可以同时进行多个任务。在您发送任务请求（启动任务）时，Amazon Glacier 会向您返回一个任务 ID，以跟踪该任务。每个任务都会由以下格式的 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 支持设置、获取和删除通知配置的操作。如果您删除了通知配置，则针对该文件库的任何数据检索操作完成时，系统都不会发送任何通知。