Amazon Glacier
开发人员指南 (API 版本 2012-06-01)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

jobParameters

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

内容

ArchiveId

您需要的档案的 ID。如果 Type 字段设置为 selectarchive-retrieval,则此字段是必需的。如果您为清单取回任务请求指定此字段,则会出现错误。

有效值:必须为您从之前发送到 Amazon Glacier 的请求获取的有效档案 ID。

类型:字符串

必需:如果 Type 设置为 selectarchive-retrieval,则是必需的。

Description

任务的可选描述。

有效值:描述的长度必须小于或等于 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-retrievalselect 任务请求指定此字段,则会出现错误。

类型:字符串

必需:否

SelectParameters

一个对象,其中包含有关用于 select 的参数的信息。

类型SelectParameters 对象

必需:否

SNSTopic

任务完成并且输出已准备好供您下载时 Amazon Glacier 向其发送通知的 Amazon SNS 主题的 Amazon Resource Name (ARN)。指定的主题会向其订阅者发布通知。

SNS 主题必须存在。如果不存在,则 Amazon Glacier 不会为您创建该主题。此外,SNS 主题必须拥有允许创建任务的账户向主题发布消息的策略。有关 SNS 主题名称的信息,请参阅《Amazon Simple Notification Service API Reference》中的“CreateTopic”

类型:字符串

必需:否

套餐

用于 select 或档案检索任务的层。Standard 是默认使用的值。

有效值: Expedited | Standard | Bulk

类型:字符串

必需:否

Type

任务类型。您可以启动任务以对档案执行 select 查询、检索档案或获取文件库的清单。

有效值: select | archive-retrieval | inventory-retrieval

类型:字符串

必需:是

更多信息

本页内容: