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