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

功能描述

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

当前图像分割中人像分割(SegmentBody)为异步接口,需要调用GetAsyncJobResult来获取真实的请求结果。

调试

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

请求参数

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

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

JobId String E75FE679-0303-4DD1-8252-1143B4FA8A27

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

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

ErrorCode String InvalidParameter

异步任务错误码。

ErrorMessage String 非法入参

异步任务错误码信息。

JobId String 49E2CC28-ED1D-4CC5-854D-7D0AE2B20976

异步任务Id。

Result String {"ImageUrl":"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_/2020-4-2/invi__015858226731531000018_UE7B9p.png?Expires=1585824473&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRpDvh1&Signature=etyeYQQ%2BWAyQTqQKd8Xq0GiOW40%3D"}

异步任务返回的真实请求结果。需要自己进行反序列化。

Status String PROCESS_SUCCESS

异步任务状态。包括:

  • QUEUING:任务排队中
  • PROCESSING:异步处理中
  • PROCESS_SUCCESS:处理成功
  • PROCESS_FAILED:处理失败
  • TIMEOUT_FAILED:任务超时未处理完成
  • LIMIT_RETRY_FAILED:超过最大重试次数
RequestId String 43A0AEB6-45F4-4138-8E89-E1A5D63200E3

当前请求的request id。

示例

请求示例

http(s)://[Endpoint]/?Action=GetAsyncJobResult
&JobId=E75FE679-0303-4DD1-8252-1143B4FA8A27
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>43A0AEB6-45F4-4138-8E89-E1A5D63200E3</RequestId>
<Data>
    <Status>PROCESS_SUCCESS</Status>
    <JobId>186AC396-0EEC-46F1-AAA1-BF3585227427</JobId>
    <Result>{"ImageUrl":"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_/2020-4-2/invi__015858228333801000019_zs0HOi.png?Expires=1585824633&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRpDvh1&amp;Signature=YHSg24oLm3yk********%3D"}</Result>
    <status>PROCESS_SUCCESS</status>
</Data>

JSON 格式

{
  "RequestId": "43A0AEB6-45F4-4138-8E89-E1A5D63200E3",
  "Data": {
    "Status": "PROCESS_SUCCESS",
    "JobId": "186AC396-0EEC-46F1-AAA1-BF3585227427",
    "Result": "{\"ImageUrl\":\"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_/2020-4-2/invi__015858228333801000019_zs0HOi.png?Expires=1585824633&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRpDvh1&Signature=YHSg24oLm3yk********%3D\"}",
    "status": "PROCESS_SUCCESS"
  }
}

Result反序列化

将上面Result反序列化展示如下。


{
  "ImageUrl": "http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_/2020-4-2/invi__015858228333801000019_zs0HOi.png?Expires=1585824633&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRpDvh1&Signature=YHSg24oLm3yk********%3D"
}

错误码

详情请参见常见错误码

SDK参考

单击SDK简介查看SDK信息。