本文介绍查询异步任务结果GetAsyncJobResult的语法及示例。

功能描述

针对异步接口,调用API接口后,返回的并不是真正的请求结果,您需要保存返回结果中的RequestId,然后调用GetAsyncJobResult来获取真正的请求结果。

说明
  • 异步任务的文件有过期时间,有效期是30分钟。如需长期使用,需及时将文件下载到本地服务器或存储在OSS中。有关OSS更多操作信息,请参见上传文件
  • 您可以进入在线咨询获取在线人工帮助。
  • 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

示例代码

该能力常用语言查询异步任务结果的示例代码,请参见查询异步任务结果示例代码

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String GetAsyncJobResult

系统规定参数。取值:GetAsyncJobResult

JobId String B6590005-5E7C-4A25-8F97-4479888D8271

输入异步接口返回的RequestId,输入后可以查询异步接口的真实请求结果。

返回数据

名称 类型 示例值 描述
RequestId String 0E448D84-1736-1BCD-BEA5-866C413515A1

请求ID。

Data Object

返回的数据内容。

Status String PROCESS_SUCCESS

异步任务状态。包括:

  • QUEUING:任务排队中
  • PROCESSING:异步处理中
  • PROCESS_SUCCESS:处理成功
  • PROCESS_FAILED:处理失败
  • TIMEOUT_FAILED:任务超时未处理完成
  • LIMIT_RETRY_FAILED:超过最大重试次数
ErrorMessage String paramsIllegal

异步任务错误码信息。

Result String "{\"jsonUrl\":\"http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-11-16/01%3A52-crxCR763VXTeY0bP.json?Expires=1673425915&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=iW07EIZaqaiMNoF3RJZwsLVxOx****\",\"pdfUrl\":\"http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-11-16/01%3A52-crxCR763VXTeY0bP.pdf?Expires=1673425916&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=BvZ3ayeTTxaR65ZvQ2%2FoE8W8Lr****\"}"

异步任务返回的真实请求结果。

ErrorCode String InvalidParameter

异步任务错误码。

JobId String A421D5F0-4F73-19F5-8D92-D509FAD281D2

异步任务ID。

SDK参考

阿里云视觉AI能力推荐使用SDK调用,支持多种编程语言,具体可参见SDK总览

示例

请求示例

http(s)://viapi.cn-shanghai.aliyuncs.com/?action=GetAsyncJobResult //更多关于访问域名(Endpoint)信息,请参见:https://help.aliyun.com/document_detail/143103.html 
&JobId=B6590005-5E7C-4A25-8F97-4479888D8271
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<GetAsyncJobResultResponse>
    <RequestId>0E448D84-1736-1BCD-BEA5-866C413515A1</RequestId>
    <Data>
        <Status>PROCESS_SUCCESS</Status>
        <JobId>A421D5F0-4F73-19F5-8D92-D509FAD281D2</JobId>
        <Result>{"jsonUrl":"http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-11-16/01%3A52-crxCR763VXTeY0bP.json?Expires=1673425915&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=iW07EIZaqaiMNoF3RJZwsLVxOx****","pdfUrl":"http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-11-16/01%3A52-crxCR763VXTeY0bP.pdf?Expires=1673425916&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=BvZ3ayeTTxaR65ZvQ2%2FoE8W8Lr****"}</Result>
    </Data>
</GetAsyncJobResultResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0E448D84-1736-1BCD-BEA5-866C413515A1",
  "Data" : {
    "Status" : "PROCESS_SUCCESS",
    "JobId" : "A421D5F0-4F73-19F5-8D92-D509FAD281D2",
    "Result" : "{\"jsonUrl\":\"http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-11-16/01%3A52-crxCR763VXTeY0bP.json?Expires=1673425915&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=iW07EIZaqaiMNoF3RJZwsLVxOx****\",\"pdfUrl\":\"http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-11-16/01%3A52-crxCR763VXTeY0bP.pdf?Expires=1673425916&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=BvZ3ayeTTxaR65ZvQ2%2FoE8W8Lr****\"}"
  }
}

错误码

关于查询异步任务结果的错误码,详情请参见常见错误码

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。