开发者社区 问答 正文

Job任务状态查询



描述


此操作会返回之前创建的Job信息,包括Job创建日期、类型、状态代码、状态消息等

请求参数




请求头部


无,其他公共请求头部参见2.4.1

请求体




返回头部


无,其他公共返回头部参见2.4.2

返回体

  • [backcolor=transparent]Action

任务类型,对于archive-retrieval类型,返回ArchiveRetrieval
对于inventory-retrieval类型,返回InventoryRetrieval
对于pull-from-oss类型,返回PullFromOSS
对于push-to-oss类型,返回PushToOSS
  • [backcolor=transparent]ArchiveId

对于archive-retrieval,push-to-oss任务,该值为创建Job时指定的ArchiveID
对于pull-from-oss任务,Job完成时,该值为归档存储产品生成的ArchiveId;Job未完成时,该值为空串(””)
对于inventory-retrieval任务,该值为空串(””)
  • [backcolor=transparent]ArchiveSizeInBytes

如果Job是archive-retrieval,pull-from-oss, push-to-oss类型,Job完成时,该值为创建Job时指定的Archive的大小(以字节为单位)
如果Job是inventory-retrieval类型或者 Job未完成,该值为-1
  • [backcolor=transparent]TreeEtag

Job对应范围的校验码,对于inventory-retrieval类型、未完成或者不满足tree-hash树对齐(2.5.4)的archive-retrieval类型Job,该值为空串(””)。
  • [backcolor=transparent]ArchiveTreeEtag

Archive的校验码,对于inventory-retrieval类型或未完成的archive-retrieval,pull-from-oss, push-to-oss类型Job,该值为空串(””)。
  • [backcolor=transparent]Completed

指示Job是否完成,Job完成时,用户可以使用Job Output下载(4.4.2)获取Job结果
  • [backcolor=transparent]CompletionDate

Job请求完成的GMT时间,当Job正在进行时,该值为空串(””)
  • [backcolor=transparent]CreationDate

创建Job的GMT时间
  • [backcolor=transparent]InventorySizeInBytes

如果Job是inventory-retrieval类型,Job完成时,该值为可下载的Archive列表信息的字节数
如果Job是archive-retrieval,pull-from-oss, push-to-oss类型或者Job未完成,该值为-1
  • [backcolor=transparent]JobDescription

创建Job时提供的Job描述
  • [backcolor=transparent]JobId

Job ID
  • [backcolor=transparent]RetrievalByteRange

初始化archive-retrieval类型Job时指定的Archive需要取出的字节范围,如果未指定,则返回整个Archive字节范围, 对于inventory-retrieval,pull-from-oss, push-to-oss类型Job,该字段为空串(””)
  • [backcolor=transparent]StatusCode

状态代码可以是InProgress、Succeeded或Failed,它指示Job状态
  • [backcolor=transparent]StatusMessage

Job状态消息

示例GET /vaults/[VaultId]/jobs/JobId HTTP/1.1
Host: cn-hangzhou.oas.aliyuncs.com
Date: Tue, 25 Mar 2014 12:00:00 GMT
x-oas-version: 2014-01-01
Authorization: [SignatureValue]




请求示例
返回示例
```HTTP/1.1 200 OKx-oas-request-id: [RequestId]Date: Tue, 25 Mar 2014 12:00:00 GMTContent-Type: application/jsonContent-Length: 443
{ “Action”: “ArchiveRetrieval”, “ArchiveId”: “0BCC996ACD22401A823E44FD553CA823C38A0963C98A1CCCA2B013E5D847F46C675DA67DEC135C292C9C5ECC9D24F2FF”, “ArchiveSizeInBytes”: 1024, “TreeEtag”: “DBB87C0A23C894006EA80A386314D003”, “ArchiveTreeEtag”: “B78BDC0A23C894006EA80A386314D003”, “Completed”: true, “CompletionDate”: “Tue, 25 Mar 2014 11:55:42 GMT”, “CreationDate”: “Tu

展开
收起
云栖大讲堂 2017-10-26 14:23:25 2198 分享 版权
阿里云 AI 助理回答

根据您的描述,您想了解关于查询Job信息的接口响应内容及其细节。虽然提供的参考资料与具体API操作有所差异,但可以基于通用的结构化信息模式为您概述返回的Job信息关键点:

返回体参数说明

  1. Action(任务类型):

    • 描述:指示Job的具体类型,如ArchiveRetrievalInventoryRetrievalPullFromOSSPushToOSS
  2. ArchiveId:

    • 对于archive-retrievalpush-to-oss任务,此值为创建Job时指定的档案ID;对于pull-from-oss任务,在Job完成后提供;对于inventory-retrieval任务则为空串。
  3. ArchiveSizeInBytes:

    • 若Job涉及档案检索、从OSS拉取或推送到OSS,并且已完成,该值表示档案大小(字节);对于清单检索或未完成的任务,则为-1。
  4. TreeEtag:

    • 提供Job对应范围的校验码,若不适用或Job未完成则为空串。
  5. ArchiveTreeEtag:

    • 表示档案的校验码,对于清单检索或未完成的相应任务为空串。
  6. Completed:

    • 指示Job是否已完成,决定用户能否获取Job结果。
  7. CompletionDate:

    • 记录Job完成的GMT时间,进行中则为空串。
  8. CreationDate:

    • 创建Job的GMT时间。
  9. InventorySizeInBytes:

    • 仅对清单检索任务有效,完成时提供档案列表信息的字节数;其他情况为-1。
  10. JobDescription:

    • 创建Job时用户提供的描述信息。
  11. JobId:

    • Job的唯一标识符。
  12. RetrievalByteRange:

    • 针对档案检索任务指定的字节范围,未指定则为整个档案;其他类型任务则为空串。
  13. StatusCode:

    • 反映Job状态的代码,可能值包括InProgress(进行中)、Succeeded(成功)或Failed(失败)。
  14. StatusMessage:

    • 提供有关Job状态的详细消息。

示例

请求示例展示了如何通过HTTP GET方法查询特定Job的详情,包括设置正确的Host、Date、x-oas-version等头部信息,并携带签名认证。

返回示例展示了一个成功的HTTP响应,包含Job的各种属性,如ActionArchiveRetrieval,提供了ArchiveId、完成状态、完成日期等详细信息。

请注意,实际应用中需根据具体的API文档调整请求格式和处理逻辑,确保与目标服务兼容。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答
问答分类:
问答地址: