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

功能描述

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

说明 异步任务的文件有过期时间,有效期是30分钟。如需长期使用,需及时将文件下载到本地服务器或存储在OSS中。有关OSS更多操作信息,请参见上传文件

当前目标检测类目中IPC视频目标检测(DetectVideoIPCObject)为异步接口,需要调用GetAsyncJobResult来获取真实的请求结果。

调试

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

请求参数

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

系统规定参数。取值:GetAsyncJobResult。

JobId String 35B11E1B-800C-4598-B5AA-577E3BDBD917

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

返回数据

名称 类型 示例值 描述
RequestId String 87FC80D2-2571-4BBD-BD61-AFF7912C556D

请求ID。

Data Object

返回的结果数据内容。

Status String PROCESS_SUCCESS

异步任务状态。包括:

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

异步任务错误码信息。

Result String {\"inputFile\":\"oss://public-vigen-video/guotian.xgt/test_images/test_video\",\"width\":1280,\"height\":720,\"frames\":[{\"time\":6124533574,\"elements\":[{\"type\":\"PERSON\",\"score\":0.7812,\"x\":289,\"y\":271,\"width\":100,\"height\":156},{\"type\":\"PERSON\",\"score\":0.4377,\"x\":917,\"y\":267,\"width\":34,\"height\":51}]}]}]}"}

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

ErrorCode String InvalidParameter

异步任务错误码。

JobId String 35B11E1B-800C-4598-B5AA-577E3BDBD917

异步任务ID。

示例

请求示例

http(s)://[Endpoint]/?JobId=35B11E1B-800C-4598-B5AA-577E3BDBD917
&公共请求参数

正常返回示例

XML格式

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

<RequestId>87FC80D2-2571-4BBD-BD61-AFF7912C556D</RequestId>
<Data>
    <Status>PROCESS_SUCCESS</Status>
    <ErrorMessage>paramsIllegal</ErrorMessage>
    <Result>{\"inputFile\":\"oss://public-vigen-video/guotian.xgt/test_images/test_video\",\"width\":1280,\"height\":720,\"frames\":[{\"time\":6124533574,\"elements\":[{\"type\":\"PERSON\",\"score\":0.7812,\"x\":289,\"y\":271,\"width\":100,\"height\":156},{\"type\":\"PERSON\",\"score\":0.4377,\"x\":917,\"y\":267,\"width\":34,\"height\":51}]}]}]}"}</Result>
    <ErrorCode>InvalidParameter</ErrorCode>
    <JobId>35B11E1B-800C-4598-B5AA-577E3BDBD917</JobId>
</Data>

JSON格式

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

{
  "RequestId" : "87FC80D2-2571-4BBD-BD61-AFF7912C556D",
  "Data" : {
    "Status" : "PROCESS_SUCCESS",
    "ErrorMessage" : "paramsIllegal",
    "Result" : "{\\\"inputFile\\\":\\\"oss://public-vigen-video/guotian.xgt/test_images/test_video\\\",\\\"width\\\":1280,\\\"height\\\":720,\\\"frames\\\":[{\\\"time\\\":6124533574,\\\"elements\\\":[{\\\"type\\\":\\\"PERSON\\\",\\\"score\\\":0.7812,\\\"x\\\":289,\\\"y\\\":271,\\\"width\\\":100,\\\"height\\\":156},{\\\"type\\\":\\\"PERSON\\\",\\\"score\\\":0.4377,\\\"x\\\":917,\\\"y\\\":267,\\\"width\\\":34,\\\"height\\\":51}]}]}]}\"}",
    "ErrorCode" : "InvalidParameter",
    "JobId" : "35B11E1B-800C-4598-B5AA-577E3BDBD917"
  }
}

错误码

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

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

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