此页面仅适用于使用文件库和 2012 年原始 REST API 的 Amazon Glacier 服务的现有客户。
如果您正在寻找归档存储解决方案，建议使用 Amazon S3 中的 Amazon Glacier 存储类别 S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive。要了解有关这些存储选项的更多信息，请参阅 Amazon Glacier 存储类别
Amazon Glacier（最初基于保管库的独立服务）不再接受新客户。Amazon Glacier 是一项独立的服务 APIs ，拥有自己的服务，可将数据存储在文件库中，不同于亚马逊 S3 和 Amazon S3 Glacier 存储类别。在 Amazon Glacier 中，您现有的数据将确保安全，并且可以无限期地访问。无需进行迁移。对于低成本、长期的存档存储， AWS 建议使用 Amazon S3 Glacier 存储类别，这些存储类别
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
jobParameters
提供用于定义任务的选项。
目录
- ArchiveId
-
您需要的档案的 ID。如果
Type字段设置为select或archive-retrieval，则此字段是必需的。如果您为清单检索任务请求指定此字段，则会出现错误。有效值：必须为您从之前发送到 Amazon Glacier（Amazon Glacier）的请求获取的有效档案 ID。
类型：字符串
是否必需：如果
Type设置为select或archive-retrieval，则是必需的。 - 描述
-
任务的可选描述。
有效值：描述的长度必须小于或等于 1024 字节。允许的字符为不含控制代码的 7 位 ASCII 字符，明确说来就是 ASCII 值为 32-126（十进制）或 0x20-0x7E（十六进制）的字符。
类型：字符串
是否必需：否
- Format
-
（可选）在启动任务以检索文件库清单时的输出格式。如果您要启动清单任务，并且不指定
Format字段，则 JSON 为默认格式。有效值：
CSV|JSON类型：字符串
是否必需：否
- InventoryRetrievalParameters
-
用于范围清单检索的输入参数。
类型：InventoryRetrievalJobInput 对象
是否必需：否
- OutputLocation
-
一个对象，其中包含有关选择任务结果的存储位置的信息。
类型：OutputLocation 对象
是否必需：对于
select任务是必需的。 - RetrievalByteRange
-
用于检索
archive-retrieval的字节范围，采用格式“StartByteValue-EndByteValue”。如果不指定此字段，则会检索整个档案。如果指定此字段，则字节范围必须以兆字节（1024*1024）对齐。兆字节对齐意味着 StartByteValue 必须可被 1 MB 整除，而且 EndByteValue 加 1 必须可被 1 MB 整除或者是指定为档案字节大小值减去 1 的档案的结尾。如果 RetrievalByteRange 没有以兆字节对齐，则此操作会返回400响应。如果您为
inventory-retrieval或select任务请求指定此字段，则会出现错误。类型：字符串
是否必需：否
- SelectParameters
-
一个对象，其中包含有关用于选择任务的参数的信息。
类型：SelectParameters 对象
是否必需：否
- SNSTopic
-
任务完成并且输出已准备好供您下载时 Amazon Glacier 向其发送通知的 Amazon SNS 主题的 Amazon 资源名称（ARN）。指定的主题会向其订阅者发布通知。
SNS 主题必须存在。如果不存在，则 Amazon Glacier 不会为您创建该主题。此外，SNS 主题必须拥有允许创建任务的账户向主题发布消息的策略。有关 SNS 主题名称的信息，请参阅《Amazon Simple Notification Service API 参考》中的 CreateTopic。
类型：字符串
是否必需：否
- Tier
-
用于选择任务或档案检索任务的套餐。默认值为
Standard。有效值：
Expedited|Standard|Bulk类型：字符串
是否必需：否
- Type
-
任务类型。您可以启动任务以对档案执行选择查询、检索档案或获取文件库的清单。
有效值：
select|archive-retrieval|inventory-retrieval类型：字符串
是否必需：是
更多信息
