全部产品
Search

搜索本产品

    智能媒体服务：QueryDNAJobList - 查询DNA作业列表

    文档中心

    智能媒体服务：QueryDNAJobList - 查询DNA作业列表

    更新时间：Sep 02, 2026

    调用QueryDNAJobList查询DNA作业。

    调试

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

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ice:QueryDNAJobList

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    JobIds

    string

    否

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

    88c6ca184c0e47098a5b665e2a12****

    返回参数

    名称

    类型

    描述

    示例值

    object

    RequestId

    string

    请求 ID。

    25818875-5F78-4A13-BEF6-D7393642CA58
    JobList

    array<object>

    DNA 作业信息。

    array<object>

    DNAJob

    DNAResult

    string

    DNA 结果链接。

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

    string

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

    3ca84a39a9024f19853b21be9cf9****
    DBId

    string

    DNA 库 Id。

    2288c6ca184c0e47098a5b665e2a12****
    CreationTime

    string

    作业创建时间。

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

    string

    作业完成时间。

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

    string

    作业状态，可取值：

    • Queuing：排队中。

    • Analysing：分析中。

    • Success：成功。

    • Fail：失败。

    Queuing
    Message

    string

    作业执行错误信息。

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

    string

    DNA 配置。

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

    string

    用户自定义数据。

    testdna
    Code

    string

    作业执行错误码。

    "InvalidParameter.ResourceNotFound"
    Input

    object

    输入文件。

    Type

    string

    输入文件类型，取值：

    1. OSS：OSS 文件地址

    2. Media：媒资 ID

    Media
    Media

    string

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

    1、oss://bucket/object

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

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

    1b1b9cd148034739af413150fded****
    Id

    string

    作业 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****"
    }
  ]
}

    错误码

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

    变更历史

    更多信息，参考变更详情。