**此页面仅适用于使用文件库和 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 存储类别。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# GlacierJobDescription
包含 Amazon Glacier（Amazon Glacier）任务的描述。
## 目录
**Action**
任务类型。它为 `ArchiveRetrieval`、`InventoryRetrieval` 或 `Select`。
*类型*：字符串
**ArchiveId**
为选择任务或档案检索任务请求的档案 ID。否则，此字段为 `null`。
*类型*：字符串
**ArchiveSHA256TreeHash**
档案检索操作的整个档案的 SHA256 树形哈希。对于清单检索任务，此字段为 `null`。
*类型*：字符串
**ArchiveSizeInBytes**
对于 `ArchiveRetrieval` 任务，这是正在请求下载的档案的大小（以字节为单位）。对于 `InventoryRetrieval` 任务，该值为 `null`。
*类型*：数字
**Completed**
如果任务已完成，则为 `true`；否则为 `false`。
*类型*：布尔值
**CompletionDate**
任务完成的日期。
任务请求完成时的通用协调时间（UTC）时间。当任务正在进行时，该值将为空。
*类型*：以 ISO 8601 日期格式表示的字符串，例如 `2013-03-20T17:03:43.221Z`。
**CreationDate**
任务启动时的通用协调时间（UTC）日期。
*类型*：以 ISO 8601 日期格式表示的字符串，例如 `2013-03-20T17:03:43.221Z`。
**InventoryRetrievalParameters**
用于范围清单检索的输入参数。
*类型*：[InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) 对象
**InventorySizeInBytes**
对于 `InventoryRetrieval` 任务，这是请求下载的清单的大小（以字节为单位）。对于 `ArchiveRetrieval` 或 `Select` 任务，该值为 `null`。
*类型*：数字
**JobDescription**
您在启动任务时提供的任务描述。
*类型*：字符串
**JobId**
标识 Amazon Glacier 中的任务的 ID。
*类型*：字符串
**JobOutputPath**
包含任务输出位置。
*类型*：字符串
**OutputLocation**
一个对象，其中包含有关选择任务结果和错误的存储位置的信息。
*类型*：[OutputLocation](api-OutputLocation.md) 对象
**RetrievalByteRange**
档案检索任务所检索的字节范围，格式为“*StartByteValue*-*EndByteValue*”。如果没有在档案检索中指定范围，则检索整个档案，并且 *StartByteValue* 等于 0，*EndByteValue* 等于档案大小减去 1。对于清单检索任务，此字段为 `null`。
*类型*：字符串
**SelectParameters**
一个对象，其中包含有关用于选择任务的参数的信息。
*类型*：[SelectParameters](api-SelectParameters.md) 对象
**SHA256TreeHash**
档案请求范围的 SHA256 树形哈希值。如果档案的[启动任务（POST jobs）](api-initiate-job-post.md)请求指定了以树形哈希对齐的范围，则此字段会返回值。有关档案范围检索的树形哈希对齐的更多信息，请参阅[下载数据时接收校验和](checksum-calculations-range.md)。
对于检索整个档案时的特定情况，此值与 `ArchiveSHA256TreeHash` 值相同。
在以下情况中，此字段为 `null`：
+ 指定未以树形哈希对齐的范围的档案检索任务。
+ 指定等于整个档案的范围并且任务状态为 `InProgress` 的档案任务。
+ 清单任务。
+ 选择任务。
*类型*：字符串
**SNSTopic**
表示 Amazon SNS 主题的 Amazon 资源名称（ARN）；如果在任务启动（[启动任务（POST jobs）](api-initiate-job-post.md)）中配置了通知，则系统会向该主题发送任务完成或失败的通知。
*类型*：字符串
**StatusCode**
指示任务状态的代码。
*有效值*：`InProgress` \$1 `Succeeded` \$1 `Failed`
*类型*：字符串
**StatusMessage**
任务状态消息。
*类型*：字符串
**Tier**
用于选择任务或档案检索任务的数据访问套餐。
*有效值*：`Expedited` \$1`Standard` \$1`Bulk`
*类型*：字符串
**VaultARN**
任务为其子资源的文件库的 ARN。
*类型*：字符串
## 更多信息
+ [启动任务（POST jobs）](api-initiate-job-post.md)