文档

QueryDNAJobList - 查询DNA作业列表

更新时间:

调用QueryDNAJobList查询DNA作业。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
JobIdsstring

需要查询的 DNA 作业 ID 列表。一次最多建议查询 10 个,用半角逗号(,)分隔。

88c6ca184c0e47098a5b665e2a12****

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

25818875-5F78-4A13-BEF6-D7393642CA58
JobListobject []

DNA 作业信息。

DNAResultstring

DNA 结果链接。

http://test_bucket.oss-cn-shanghai.aliyuncs.com/fingerprint/video/search_result/5/5.txt
PrimaryKeystring

唯一的视频主键,唯一性由用户保证。

3ca84a39a9024f19853b21be9cf9****
DBIdstring

DNA 库 Id。

2288c6ca184c0e47098a5b665e2a12****
CreationTimestring

作业创建时间。

2022-12-28T03:21:37Z
FinishTimestring

作业完成时间。

2022-12-28T03:21:44Z
Statusstring

作业状态,可取值:

  • Queuing:排队中。
  • Analysing:分析中。
  • Success:成功。
  • Fail:失败。
Queuing
Messagestring

作业执行错误信息。

"The resource operated \"a887d0b***d805ef6f7f6786302\" cannot be found"
Configstring

DNA 配置。

{"SaveType": "save","MediaType"":"video"}
UserDatastring

用户自定义数据。

testdna
Codestring

作业执行错误码。

"InvalidParameter.ResourceNotFound"
Inputobject

输入文件。

Typestring

输入文件类型,取值:

  1. OSS:OSS 文件地址
  2. Media:媒资 ID
Media
Mediastring

输入文件信息,支持 OSS 地址和媒资 ID 两种。 OSS 地址规则为

1、oss://bucket/object

2、http(s)://bucket.oss-[regionId].aliyuncs.com/object

其中 bucket 为和当前项目处于同一区域的 oss bucket 名称,object 为文件路径。

1b1b9cd148034739af413150fded****
Idstring

作业 ID。

88c6ca184c0e47098a5b665e2a12****

DNAResult 的内容为 Array of VideoMatchInfo,其中:

VideoMatchInfo 详情

名称类型描述
PrimaryKeyString匹配文件唯一主键。
GlobalSimilarityDouble整体相似度。
VideoMatchSegmentsArray of VideoMatchSegment视频/图搜视频匹配片段信息。
AudioMatchSegmentsArray of AudioMatchSegment音频搜音频匹配片段信息。
TextMatchSegmentsArray of TextMatchSegment文本搜文本匹配片段信息。

VideoMatchSegment/AudioMatchSegment 详情

名称类型描述
StartTimeDouble输入视频/音频的开始时间。
EndTimeDouble输入视频/音频的结束时间。
MasterStartTimeDouble库中视频/音频的开始时间。
MasterEndTimeDouble库中视频/音频的结束时间。
SimilarityDouble匹配片段的置信度。

TextMatchSegment 详情

名称类型描述
StartDouble查询匹配片段起始时间。
EndDouble查询匹配片段结束时间。
QueryTextString查询匹配的文本片段。
MasterTextString底库匹配的文本片段。
SimilarityDouble匹配片段的置信度。

示例

正常返回示例

JSON格式

{
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  "JobList": [
    {
      "DNAResult": "http://test_bucket.oss-cn-shanghai.aliyuncs.com/fingerprint/video/search_result/5/5.txt",
      "PrimaryKey": "3ca84a39a9024f19853b21be9cf9****",
      "DBId": "2288c6ca184c0e47098a5b665e2a12****",
      "CreationTime": "2022-12-28T03:21:37Z",
      "FinishTime": "2022-12-28T03:21:44Z",
      "Status": "Queuing",
      "Message": "\"The resource operated \\\"a887d0b***d805ef6f7f6786302\\\" cannot be found\"",
      "Config": "{\"SaveType\": \"save\",\"MediaType\"\":\"video\"}",
      "UserData": "testdna",
      "Code": "\"InvalidParameter.ResourceNotFound\"",
      "Input": {
        "Type": "Media",
        "Media": "1b1b9cd148034739af413150fded****"
      },
      "Id": "88c6ca184c0e47098a5b665e2a12****"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-05-25API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
  • 本页导读 (1)
文档反馈