jobParameters - Amazon S3 Glacier
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

jobParameters

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

Contents

ArchiveId

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

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

类型:字符串

必需:是的Type设置为select或者archive-retrieval

描述

任务的可选描述。

有效 值:描述的长度必须小于或等于 1024 字节。允许的字符为不含控制代码的 7 位 ASCII 字符,明确说来就是 ASCII 值为 32—126(十进制)或 0x20—0x20—0x20—0x20—0x0x7E(十六进制)的字符。

类型:字符串

必需:否

格式

(可选) 在启动任务以检索文件库清单时的输出格式。如果您要启动清单任务,并且不指定 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 SNS 主题的 Amazon 资源名称 (ARN),在该主题中,S3 Glacier 会在作业完成并且输出已准备好供您下载时发送通知。指定的主题会向其订阅者发布通知。

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

类型:字符串

必需:否

Tier

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

有效值: Expedited | Standard | Bulk

类型:字符串

必需:否

类型

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

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

类型:字符串

必需:是

更多信息