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

功能描述

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

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

当前图像分析处理类目中新冠病毒肺炎辅助诊断（DetectCovid19Cad）为异步接口，需要调用GetAsyncJobResult来获取真实的请求结果。

调试

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

请求参数

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

系统规定参数。取值：GetAsyncJobResult。
JobId String 是 7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4

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

返回数据

名称 类型 示例值 描述
RequestId String 7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4

请求ID。
Data Object

返回的结果数据内容。
Status String PROCESS_SUCCESS

异步任务状态。包括：

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

异步任务错误码信息。
Result String {\"NewProbability\":\"4.062644e-06\",\"NormalProbability\":\"0.7230905\",\"OtherProbability\":\"0.27690542\",\"LesionRatio\":\"0.9387283236994219\",\"Mask\":\"http://algo-app-aic-med-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/covid19-dcm/unspecified/2020032702/1b1e1018-6fcf-11ea-8fa1-d20b34387541.nii.gz?Expires=1585276394&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=%2F1LNGWJUqvY0VRYGgg8Ldtb3BF****\"}

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

异步任务错误码。
JobId String CCCAAAFB-5628-40DD-A12C-6F52326C1B03

异步任务ID。

示例

请求示例

http(s)://[Endpoint]/?Action=GetAsyncJobResult
&JobId=7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4
&<公共请求参数>

正常返回示例

XML格式 

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

<RequestId>7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4</RequestId>
<Data>
    <Status>PROCESS_SUCCESS</Status>
    <ErrorMessage>paramsIllegal</ErrorMessage>
    <Result>{\"NewProbability\":\"4.062644e-06\",\"NormalProbability\":\"0.7230905\",\"OtherProbability\":\"0.27690542\",\"LesionRatio\":\"0.9387283236994219\",\"Mask\":\"http://algo-app-aic-med-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/covid19-dcm/unspecified/2020032702/1b1e1018-6fcf-11ea-8fa1-d20b34387541.nii.gz?Expires=1585276394&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=%2F1LNGWJUqvY0VRYGgg8Ldtb3BF****\"}</Result>
    <ErrorCode>InvalidParameter</ErrorCode>
    <JobId>CCCAAAFB-5628-40DD-A12C-6F52326C1B03</JobId>
</Data>

JSON格式 

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

{
  "RequestId" : "7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4",
  "Data" : {
    "Status" : "PROCESS_SUCCESS",
    "ErrorMessage" : "paramsIllegal",
    "Result" : "{\\\"NewProbability\\\":\\\"4.062644e-06\\\",\\\"NormalProbability\\\":\\\"0.7230905\\\",\\\"OtherProbability\\\":\\\"0.27690542\\\",\\\"LesionRatio\\\":\\\"0.9387283236994219\\\",\\\"Mask\\\":\\\"http://algo-app-aic-med-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/covid19-dcm/unspecified/2020032702/1b1e1018-6fcf-11ea-8fa1-d20b34387541.nii.gz?Expires=1585276394&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=%2F1LNGWJUqvY0VRYGgg8Ldtb3BF****\\\"}",
    "ErrorCode" : "InvalidParameter",
    "JobId" : "CCCAAAFB-5628-40DD-A12C-6F52326C1B03"
  }
}

错误码

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

SDK参考

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

安全声明

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