调用该接口获取一体化以图搜图任务的状态。
一体化以图搜图,表示搜图时,同时检索人脸和人体特征。
说明 该功能需要在V系列边缘一体机上部署人脸和人体检测算法。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetPictureSearchJobStatus |
系统规定参数。取值:GetPictureSearchJobStatus。 |
AppInstanceId | String | 是 | 892f97c9518548469d319d955d98**** |
以图搜图应用实例ID。可调用QueryPictureSearchApps查询。 |
JobId | String | 是 | b3786935a71442efae014c7b2212**** |
以图搜图任务ID。可调用QueryPictureSearchJob查询。 |
调用API时,除了本文介绍的该API的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数文档。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | 200 |
调用失败时,返回的错误码。更多信息,请参见错误码。 |
Data | Struct |
响应结果。 |
|
CreateTime | Long | 1614850763000 |
创建以图搜图任务的时间。 |
EndTime | Long | 1614850763692 |
检索范围结束时间。 |
JobId | String | b3786935a71442efae014c7b2212**** |
以图搜图任务ID。 |
JobStatus | Integer | 3 |
任务状态:
|
SearchPicUrl | String | http://XXX.XXX.com/1.jpg |
检索图片的地址。 |
StartTime | Long | 1614814763692 |
检索范围起始时间,格式为13位时间戳,单位为毫秒。 |
Threshold | Float | 0.5 |
检索相似度。 |
ErrorMessage | String | Specified access key is not found. |
调用失败时,返回的出错信息。 |
RequestId | String | 2c7def10-7cce-11eb-8e79-959f4f722f76 |
阿里云为该请求生成的唯一标识符。 |
Success | Boolean | true |
是否调用成功:
|
示例
请求示例
http(s)://linkvisual.cn-shanghai.aliyuncs.com/?Action=GetPictureSearchJobStatus
&AppInstanceId=892f97c9518548469d319d955d98****
&JobId=b3786935a71442efae014c7b2212****
&<公共请求参数>
正常返回示例
XML
格式
<GetPictureSearchJobStatusResponse>
<RequestId>2c7def10-7cce-11eb-8e79-959f4f722f76</RequestId>
<Data>
<JobStatus>3</JobStatus>
<EndTime>1614850763692</EndTime>
<CreateTime>1614850763000</CreateTime>
<StartTime>1614814763692</StartTime>
<SearchPicUrl>http://XXX.XXX.com/1.jpg</SearchPicUrl>
<JobId>b3786935a71442efae014c7b2212****</JobId>
<Threshold>0.5</Threshold>
</Data>
<Code>200</Code>
<Success>true</Success>
</GetPictureSearchJobStatusResponse>
JSON
格式
{
"RequestId": "2c7def10-7cce-11eb-8e79-959f4f722f76",
"Data": {
"JobStatus": "3",
"EndTime": "1614850763692",
"CreateTime": "1614850763000",
"StartTime": "1614814763692",
"SearchPicUrl": "http://XXX.XXX.com/1.jpg",
"JobId": "b3786935a71442efae014c7b2212****",
"Threshold": "0.5"
},
"Code": "200",
"Success": "true"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | Forbidden.RiskControl | Your account is at risk. Contact customer support for more details. | 无权限 |
访问错误中心查看更多错误码。