**此页面仅适用于使用文件库和 2012 年原始 REST API 的 Amazon Glacier 服务的现有客户。**

如果您正在寻找归档存储解决方案，建议使用 Amazon S3 中的 Amazon Glacier 存储类别 S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive。要了解有关这些存储选项的更多信息，请参阅 [Amazon Glacier 存储类别](https://www.amazonaws.cn/s3/storage-classes/glacier/)。

Amazon Glacier（最初基于保管库的独立服务）不再接受新客户。Amazon Glacier 是一项独立的服务 APIs ，拥有自己的服务，可将数据存储在文件库中，不同于亚马逊 S3 和 Amazon S3 Glacier 存储类别。在 Amazon Glacier 中，您现有的数据将确保安全，并且可以无限期地访问。无需进行迁移。对于低成本、长期的存档存储， Amazon 建议[使用 Amazon S3 Glacier 存储类别，这些存储类别](https://www.amazonaws.cn/s3/storage-classes/glacier/)基于S3存储桶 APIs、完全 Amazon Web Services 区域 可用性、更低的成本和 Amazon 服务集成，可提供卓越的客户体验。如果您希望加强功能，可以考虑使用我们的 [Amazon 将数据从 Amazon Glacier 文件库传输到 Amazon S3 Glacier 存储类别的解决方案指南](https://www.amazonaws.cn/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)，迁移到 Amazon S3 Glacier 存储类别。

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

# 检索 Amazon Glacier 档案
<a name="downloading-an-archive-two-steps"></a>

从 Amazon Glacier 检索档案是一个异步操作，您首先需要启动任务，然后在任务完成后下载输出。要启动档案取回任务，您可以使用 [启动任务（POST jobs）](api-initiate-job-post.md) REST API 操作或中的等效操作 Amazon CLI、或 Amazon SDKs。

**Topics**
+ [档案检索选项](#api-downloading-an-archive-two-steps-retrieval-options)
+ [关于限范围的档案检索](#downloading-an-archive-range)

从 Amazon Glacier 检索档案是一个分为两个步骤的过程。下面是此过程的概述：

**检索档案**

1. 启动档案检索任务。

   1. 获得您要检索的档案的 ID。您可以从文件库清单获取档案 ID。您可以通过 REST API 获取档案 ID Amazon CLI、或 Amazon SDKs。有关更多信息，请参阅 [在 Amazon Glacier 中下载文件库清单](vault-inventory.md)。

   1. 使用[启动任务（POST jobs）](api-initiate-job-post.md)操作启动任务，请求 Amazon Glacier 为后续下载准备整个档案或档案的一部分。

   当您启动任务时，Amazon Glacier 会在响应中返回任务 ID 并异步运行任务。（如步骤 2 所述，在任务完成之前，您不能下载任务输出。）
**重要**  
数据检索策略可能导致您的 `Initiate Job` 请求失败，并发生 `PolicyEnforcedException` 异常，但这仅限于标准检索。有关数据检索策略的更多信息，请参阅 [Amazon Glacier 数据检索策略](data-retrieval-policy.md)。有关 `PolicyEnforcedException` 异常的更多信息，请参阅[错误响应](api-error-responses.md)。

   如果需要，您可以还原存储在 Amazon Glacier 中的大型数据段。有关从 Amazon Glacier 存储类别恢复数据的更多信息，请参阅《Amazon Simple Storage Service 用户指南》中的[用于归档对象的存储类别]( https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-class-intro.html#sc-glacier)**。

1. 在任务完成后，使用[获取任务输出（GET output）](api-job-output-get.md)操作下载字节。

   您可以下载所有字节，或者指定字节范围，只下载任务输出的一部分。对于较大的输出，以区块下载输出的方式在下载失败（例如，由于网络发生故障而失败）时对您有所帮助。如果您在单一请求中获取任务输出，并且网络发生故障，则您不得不从头重新开始下载输出。但是，如果您以区块下载输出，万一发生任何故障，则您只需重新开始下载较小的部分，而不是整个输出。

Amazon Glacier 必须先完成任务，然后，您才能获取其输出。任务在完成后的至少 24 小时内都不会过期，这意味着，您可以在任务完成后的 24 小时期限内下载输出。还原可以在任务完成 24 小时后随时过期。要确定您的任务是否已完成，请使用以下选项之一检查其状态：
+ **等待任务完成通知** – 您可以指定 Amazon Glacier 在完成任务后可以向其发布通知的 Amazon Simple Notification Service（Amazon SNS）主题。Amazon Glacier 只有在完成任务后才会发送通知。

  启动任务时，您可以为该任务指定 Amazon SNS 主题。除了在您的任务请求中指定 Amazon SNS 主题以外，如果您的文件库已为档案检索事件设置了通知配置，Amazon Glacier 也会向该 SNS 主题发布通知。有关更多信息，请参阅[在 Amazon Glacier 中配置文件库通知](configuring-notifications.md)。
+ **显式请求任务信息** – 您也可以使用 Amazon Glacier `Describe Job` API 操作（[描述任务（GET JobID）](api-describe-job-get.md)），以定期轮询任务信息。但是，建议使用 Amazon SNS 通知。

**注意**  
使用 Amazon SNS 通知获取的信息与调用 `Describe Job` API 操作所获取的信息相同。

## 档案检索选项
<a name="api-downloading-an-archive-two-steps-retrieval-options"></a>

在启动检索档案的任务时，您可以根据访问时间和成本需求指定以下检索选项之一。有关检索定价的信息，请参阅 [Amazon Glacier 定价](https://www.amazonaws.cn/s3/glacier/pricing/)。
+ **加速** - 加速检索允许您在偶尔需要紧急请求还原档案时快速访问存储在 S3 Glacier Flexible Retrieval 存储类别或 S3 Intelligent-Tiering 归档访问层中的数据。对于除了最大型档案（250 MB 以上）之外的所有其他档案，使用加速检索访问的数据通常在 1 到 5 分钟内可用。预配置容量确保在您需要时，可以使用针对加速检索的检索容量。有关更多信息，请参阅[预配置容量](#api-downloading-an-archive-two-steps-retrieval-expedited-capacity)。
+ **标准** –标准检索允许您在数小时内访问您的任意档案。标准检索通常在 3 到 5 小时内完成。“标准”是未指定检索选项的检索请求的原定设置选项。
+ **批量** – 批量检索是 Amazon Glacier 最低成本的检索选项，使您可以在一天内以较低的成本检索大量（甚至是 PB 级）的数据。批量检索通常在 5 到 12 小时内完成。

下表总结了归档检索选项。有关定价的信息，请参阅 [Amazon Glacier 定价](https://www.amazonaws.cn/s3/glacier/pricing/)。


| 服务 | 加速 | 标准 | 批量 | 
| --- | --- | --- | --- | 
|  Amazon Glacier  |  1–5 分钟  |  3–5 小时  |  5–12 小时  | 

要进行`Expedited``Standard`、或`Bulk`检索，`Tier`请将 [https://docs.amazonaws.cn/AmazonS3/latest/API/RESTObjectPOSTrestore.html](https://docs.amazonaws.cn/AmazonS3/latest/API/RESTObjectPOSTrestore.html)REST API 操作请求中的请求元素设置为所需的选项，或 Amazon Command Line Interface (Amazon CLI) 或中的等效选项 Amazon SDKs。如果您购买了预配置容量，则所有加速检索都会通过您的预配置容量自动获得处理。

### 预配置容量
<a name="api-downloading-an-archive-two-steps-retrieval-expedited-capacity"></a>

预配置容量帮助确保在您需要时，可以使用针对加速检索的检索容量。每个容量单位允许每 5 分钟至少执行三次加急检索，并提供高达每秒 150 兆字节的检索吞吐量 () MBps。

如果您的工作负载需要极高的稳定性和对数据子集可预测的访问性能（以分钟为单位），建议您购买预调配检索容量。没有预配置容量的加速检索通常也可以接受，但是在极少情况下会出现不寻常的高需求。不过，如果您需要随时可以访问加速检索，您必须购买预配置检索容量。

#### 购买预配置容量
<a name="downloading-an-archive-purchase-provisioned-capacity"></a>

您可以使用 Amazon Glacier 控制台、[购买预配置容量（POST provisioned-capacity）](api-PurchaseProvisionedCapacity.md) REST API 操作或购买预配置容量单位。 Amazon SDKs Amazon CLI有关预配置容量的定价信息，请参阅 [Amazon Glacier 定价](https://www.amazonaws.cn/s3/glacier/pricing/)。

预配置容量单位将持续一个月，从购买日期和时间开始计算。

如果开始日期为一个月的第 31 天，过期日期为下个月的最后一天。例如，如果开始日期为 8 月 31 日，则过期日期为 9 月 30 日。如果开始日期为 1 月 31 日，则过期日期为 2 月 28 日。

**使用 Amazon Glacier 控制台购买预配置容量**

1.  登录 Amazon Web Services 管理控制台 并在家中打开 Amazon Glacier [https://console.aws.amazon.com/glacier/主](https://console.amazonaws.cn/glacier/home)机。

1. 在左侧的导航窗格中，选择**数据检索设置**。

1. 在**预配置容量单位 (PCUs)** 下，选择**购买 PC** U。此时将显示**购买 PCU** 对话框。

1. 如果要购买预配置容量，请在**确认购买**框中输入 **confirm**。

1.  选择**购买 PCU**。

## 关于限范围的档案检索
<a name="downloading-an-archive-range"></a>

当您从 Amazon Glacier 检索归档时，您可以选择性地指定要检索的归档范围（部分）。默认为检索整个档案。如果您要执行以下操作，指定字节范围会很有用：
+ **管理您的数据下载** – Amazon Glacier 允许您在检索请求完成后的 24 小时内下载检索的数据。因此，您可能只想要检索档案的某些部分，以便在给定的下载时间窗内管理下载时间表。
+ **检索大型档案的目标段** – 例如，假设您之前聚合了许多文件并以单一档案的形式上传了这些文件，您现在想检索这些文件中的一些文件。在这种情况下，您可以通过使用一个检索请求指定档案的范围，该范围包含您感兴趣的文件。或者，您可以启动多个检索请求，每个请求均具有一个针对一个或多个文件的范围。

当使用范围检索启动检索任务时，您必须提供以兆字节对齐的范围。也就是说，字节范围可以从零（档案的开头）开始，或者从其后的任何 1-MB 间隔（1 MB、2 MB、3 MB，依此类推）处开始。

该范围的结尾可以是您档案的结尾或大于范围开头的任何 1 MB 间隔处。此外，如果您要在（检索任务完成后）下载数据时获取校验和值，则您在任务启动中请求的范围还必须以树形哈希对齐。可以使用校验和来确保数据在传输过程中没有损坏。有关兆字节对齐和树形哈希对齐的更多信息，请参阅[下载数据时接收校验和](checksum-calculations-range.md)。