如果您不熟悉 Amazon Simple Storage Service (Amazon S3) 中的归档存储功能,建议您先详细了解 Amazon S3 中的 S3 Glacier 存储类、S3 Glacier 即时检索、S3 Glacier 灵活检索和 S3 Glacier 深度归档。有关更多信息,请参阅 Amazon S3 用户指南中的 S3 Glacier 存储类
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
GlacierJobDescription
包含 Amazon S3 Glacier (S3 Glacier) 任务的描述。
目录
- Action
-
任务类型。它为
ArchiveRetrieval
、InventoryRetrieval
或Select
。类型:字符串
- ArchiveId
-
为 select 或档案检索任务请求的档案 ID。否则,此字段为
null
。类型:字符串
- ArchiveSHA256TreeHash
-
档案检索操作的整个档案的 SHA256 树形哈希。对于清单检索任务,此字段为
null
。类型:字符串
- ArchiveSizeInBytes
-
对于
ArchiveRetrieval
任务,这是正在请求下载的档案的大小(以字节为单位)。对于InventoryRetrieval
任务,该值为null
。类型:数字
- 已完成
-
如果任务已完成,则为
true
;否则为false
。类型:布尔值
- CompletionDate
-
任务完成的日期。
任务请求完成时的通用协调时间 (UTC) 时间。当任务正在进行时,该值将为空。
类型:以 ISO 8601 日期格式表示的字符串,例如
2013-03-20T17:03:43.221Z
。 - CreationDate
-
任务启动时的通用协调时间 (UTC) 日期。
类型:以 ISO 8601 日期格式表示的字符串,例如
2013-03-20T17:03:43.221Z
。 - InventoryRetrievalParameters
-
用于范围清单检索的输入参数。
- InventorySizeInBytes
-
对于
InventoryRetrieval
任务,这是请求下载的清单的大小(以字节为单位)。对于ArchiveRetrieval
或Select
任务,该值为null
。类型:数字
- JobDescription
-
您在启动任务时提供的任务描述。
类型:字符串
- JobId
-
标识 S3 Glacier 中的任务的 ID。
类型:字符串
- JobOutputPath
-
包含任务输出位置。
类型:字符串
- OutputLocation
-
一个对象,其中包含有关 select 任务结果和错误的存储位置的信息。
类型:OutputLocation 对象
- RetrievalByteRange
-
档案检索任务所检索的字节范围,格式为“
StartByteValue
-EndByteValue
”。如果没有在档案检索中指定范围,则检索整个档案,并且 StartByteValue 等于 0,EndByteValue 等于档案大小减去 1。对于清单检索任务,此字段为null
。类型:字符串
- SelectParameters
-
一个对象,其中包含有关用于 select 的参数的信息。
类型:SelectParameters 对象
- SHA256TreeHash
-
档案请求范围的 SHA256 树形哈希值。如果档案的 启动作业(POST 作业) 请求指定了以树形哈希对齐的范围,则此字段会返回值。有关档案范围检索的树形哈希对齐的更多信息,请参阅“下载数据时接收校验和”。
对于检索整个档案时的特定情况,此值与
ArchiveSHA256TreeHash
值相同。在以下情况中,此字段为
null
:-
指定未以树形哈希对齐的范围的档案检索任务。
-
指定等于整个档案的范围并且任务状态为
InProgress
的档案任务。 -
清单任务。
-
选择任务。
类型:字符串
-
- SNSTopic
-
表示 Amazon SNS 主题的 Amazon 资源名称(ARN);如果在任务启动 (启动作业(POST 作业)) 中配置了通知,则系统会向该主题发送任务完成或失败的通知。
类型:字符串
- StatusCode
-
指示任务状态的代码。
有效值:
InProgress
|Succeeded
|Failed
类型:字符串
- StatusMessage
-
任务状态消息。
类型:字符串
- 套餐
-
用于 select 或档案检索的数据访问。
有效值:
Expedited
|Standard
|Bulk
类型:字符串
- VaultARN
-
任务为其子资源的文件库的 ARN。
类型:字符串