**此页面仅适用于使用文件库和 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 存储类别。

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

# jobParameters
<a name="api-jobParameters"></a>

提供用于定义任务的选项。

## 目录
<a name="api-jobParameters-contents"></a>

**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` \$1 `JSON`   
*类型*：字符串  
*是否必需*：否

**InventoryRetrievalParameters**  
用于范围清单检索的输入参数。  
*类型*：[InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) 对象  
*是否必需*：否

**OutputLocation**  
 一个对象，其中包含有关选择任务结果的存储位置的信息。  
*类型*：[OutputLocation](api-OutputLocation.md) 对象  
*是否必需*：对于 `select` 任务是必需的。

**RetrievalByteRange**  
用于检索 `archive-retrieval` 的字节范围，采用格式“*StartByteValue*-*EndByteValue*”。如果不指定此字段，则会检索整个档案。如果指定此字段，则字节范围必须以兆字节（1024\$11024）对齐。兆字节对齐意味着 *StartByteValue* 必须可被 1 MB 整除，而且 *EndByteValue* 加 1 必须可被 1 MB 整除或者是指定为档案字节大小值减去 1 的档案的结尾。如果 **RetrievalByteRange** 没有以兆字节对齐，则此操作会返回 `400` 响应。  
如果您为 `inventory-retrieval` 或 `select` 任务请求指定此字段，则会出现错误。  
*类型*：字符串  
*是否必需*：否

**SelectParameters**  
一个对象，其中包含有关用于选择任务的参数的信息。  
*类型*：[SelectParameters](api-SelectParameters.md) 对象  
*是否必需*：否

**SNSTopic**  
任务完成并且输出已准备好供您下载时 Amazon Glacier 向其发送通知的 Amazon SNS 主题的 Amazon 资源名称（ARN）。指定的主题会向其订阅者发布通知。  
SNS 主题必须存在。如果不存在，则 Amazon Glacier 不会为您创建该主题。此外，SNS 主题必须拥有允许创建任务的账户向主题发布消息的策略。有关 SNS 主题名称的信息，请参阅《Amazon Simple Notification Service API 参考》****中的 [CreateTopic](https://docs.amazonaws.cn/sns/latest/api/API_CreateTopic.html)。  
*类型*：字符串  
*是否必需*：否

**Tier**  
用于选择任务或档案检索任务的套餐。默认值为 `Standard`。  
*有效值*：`Expedited` \$1`Standard` \$1 `Bulk`  
*类型*：字符串  
*是否必需*：否 

**Type**  
任务类型。您可以启动任务以对档案执行选择查询、检索档案或获取文件库的清单。  
*有效值*：`select` \$1 `archive-retrieval` \$1 `inventory-retrieval`   
*类型*：字符串  
*是否必需*：是

## 更多信息
<a name="more-info-api-jobParameters"></a>
+ [启动任务（POST jobs）](api-initiate-job-post.md)