GlacierJobDescription - Amazon Glacier

此页面仅适用于使用文件库和 2012 年原始 REST API 的 Amazon Glacier 服务的现有客户。

如果您正在寻找归档存储解决方案,建议使用 Amazon S3 中的 Amazon Glacier 存储类别 S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive。要了解有关这些存储选项的更多信息,请参阅 Amazon Glacier 存储类别

Amazon Glacier(最初基于保管库的独立服务)不再接受新客户。Amazon Glacier 是一项独立的服务 APIs ,拥有自己的服务,可将数据存储在文件库中,不同于亚马逊 S3 和 Amazon S3 Glacier 存储类别。在 Amazon Glacier 中,您现有的数据将确保安全,并且可以无限期地访问。无需进行迁移。对于低成本、长期的存档存储, AWS 建议使用 Amazon S3 Glacier 存储类别,这些存储类别基于S3存储桶 APIs、完全 AWS 区域 可用性、更低的成本和 AWS 服务集成,可提供卓越的客户体验。如果您希望加强功能,可以考虑使用我们的 AWS 将数据从 Amazon Glacier 文件库传输到 Amazon S3 Glacier 存储类别的解决方案指南,迁移到 Amazon S3 Glacier 存储类别。

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

GlacierJobDescription

包含 Amazon Glacier(Amazon Glacier)任务的描述。

目录

Action

任务类型。它为 ArchiveRetrievalInventoryRetrievalSelect

类型:字符串

ArchiveId

为选择任务或档案检索任务请求的档案 ID。否则,此字段为 null

类型:字符串

ArchiveSHA256TreeHash

档案检索操作的整个档案的 SHA256 树形哈希。对于清单检索任务,此字段为 null

类型:字符串

ArchiveSizeInBytes

对于 ArchiveRetrieval 任务,这是正在请求下载的档案的大小(以字节为单位)。对于 InventoryRetrieval 任务,该值为 null

类型:数字

Completed

如果任务已完成,则为 true;否则为 false

类型:布尔值

CompletionDate

任务完成的日期。

任务请求完成时的通用协调时间(UTC)时间。当任务正在进行时,该值将为空。

类型:以 ISO 8601 日期格式表示的字符串,例如 2013-03-20T17:03:43.221Z

CreationDate

任务启动时的通用协调时间(UTC)日期。

类型:以 ISO 8601 日期格式表示的字符串,例如 2013-03-20T17:03:43.221Z

InventoryRetrievalParameters

用于范围清单检索的输入参数。

类型InventoryRetrievalJobInput 对象

InventorySizeInBytes

对于 InventoryRetrieval 任务,这是请求下载的清单的大小(以字节为单位)。对于 ArchiveRetrievalSelect 任务,该值为 null

类型:数字

JobDescription

您在启动任务时提供的任务描述。

类型:字符串

JobId

标识 Amazon Glacier 中的任务的 ID。

类型:字符串

JobOutputPath

包含任务输出位置。

类型:字符串

OutputLocation

一个对象,其中包含有关选择任务结果和错误的存储位置的信息。

类型OutputLocation 对象

RetrievalByteRange

档案检索任务所检索的字节范围,格式为“StartByteValue-EndByteValue”。如果没有在档案检索中指定范围,则检索整个档案,并且 StartByteValue 等于 0,EndByteValue 等于档案大小减去 1。对于清单检索任务,此字段为 null

类型:字符串

SelectParameters

一个对象,其中包含有关用于选择任务的参数的信息。

类型SelectParameters 对象

SHA256TreeHash

档案请求范围的 SHA256 树形哈希值。如果档案的启动任务(POST jobs)请求指定了以树形哈希对齐的范围,则此字段会返回值。有关档案范围检索的树形哈希对齐的更多信息,请参阅下载数据时接收校验和

对于检索整个档案时的特定情况,此值与 ArchiveSHA256TreeHash 值相同。

在以下情况中,此字段为 null

  • 指定未以树形哈希对齐的范围的档案检索任务。

  • 指定等于整个档案的范围并且任务状态为 InProgress 的档案任务。

  • 清单任务。

  • 选择任务。

类型:字符串

SNSTopic

表示 Amazon SNS 主题的 Amazon 资源名称(ARN);如果在任务启动(启动任务(POST jobs))中配置了通知,则系统会向该主题发送任务完成或失败的通知。

类型:字符串

StatusCode

指示任务状态的代码。

有效值InProgress | Succeeded | Failed

类型:字符串

StatusMessage

任务状态消息。

类型:字符串

Tier

用于选择任务或档案检索任务的数据访问套餐。

有效值Expedited |Standard |Bulk

类型:字符串

VaultARN

任务为其子资源的文件库的 ARN。

类型:字符串

更多信息