智能多媒体服务

    • 智能多媒体服务 > 使用指南 > 开发指南 >任务查询V3

    任务查询V3

    最近更新时间: 2024-12-12 15:34:22

    用户可以使用 <persistentId> 来主动查询 任务版本为V3 的持久化处理任务的执行状态。

    备注：目前支持查询10天以内的持久化处理任务。

    接口规格

    <persistentId>
    参数名称 必填 说明
    是 上传预处理或持久化处理接口返回的<persistentId>。

    请求报文

    服务端完成所有指定的处理操作后，会将处理结果状态提交到<NotifyUrl>指向的网址。

    请求语法

    GET /v3/task/status/<persistentId> HTTP/1.1
Host: dora.qiniuapi.com  

Content-Type: application/x-www-form-urlencoded  
Authorization: Qiniu <AccessToken>

    其中AccessToken的生成算法可参见管理凭证。

    头部信息

    头部名称 必填 说明
    Host 是 固定为 dora.qiniuapi.com。

    响应报文

    响应语法

    HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: <prefopResponseContentLength>

<prefopResponseContent>

    头部信息

    头部名称 必填 说明
    Content-Type 是 正常情况下该值将被设为application/json，表示返回JSON格式的文本信息。

    响应内容

    • 基本属性

      是一个JSON对象。定义：{当前任务的基本属性}，字段如下。

      字段名称 说明
      version 版本号，统一都为“v3”
      id 任务ID
      reqid 云处理请求的请求id，主要用于七牛技术人员的问题排查。
      pipeline 默认使用队列为：default.sys
      created_at 任务创建的时间戳，单位为毫秒

    • 任务处理对象

      是一个JSON对象。定义：{input}，字段如下。

      字段名称 说明
      bucket 输入文件，当前仅支持kodo文件，待处理文件所在存储空间
      key 待处理文件名
      hash 云处理结果保存在服务端的唯一hash标识

    • 任务结果

      是一个JSON对象。定义：{任务处理结果}，字段如下。

      字段名称 说明
      code 返回码， 0成功、1等待处理、2处理中、3失败、5已取消(删除pipeline时，并且有任务还在等待中)
      desc 返回信息描述，例如： success

    • 工作流节点处理详情

      是一个JSON对象组，所有工作流节点处理的详情。定义：{ops}

    • 示例

      如果请求成功，返回包含如下内容的JSON字符串（已格式化，便于阅读）：

    {
    "code": 0, 
    "created_at": 1609830317402, 
    "desc": "successfully completed", 
    "id": "z0.01z002c8b17y9mewnd00mtwhak00019s", 
    "input": {
        "kodo_file": {
            "bucket": "st-qtest-in", 
            "key": "foreman.mp4"
        }
    }, 
    "ops": [
        {
            "fop": {
                "cmd": "tetras_cloud_codec", 
                "input_from": "__origin__", 
                "result": {
                    "code": 0, 
                    "desc": "successfully completed", 
                    "has_output": false
                }
            }, 
            "id": "A"
        }, 
        {
            "depends": [
                "A"
            ], 
            "fop": {
                "cmd": "saveas/c3QtcXRlc3Qtb3V0OmZvcmVtYW5fb3V0cHV0Lm1wNA==/jsonQuery/eyJidWNrZXQiOiJzdC1xdGVzdC1vdXQiLCJrZXlfdGVtcGxhdGUiOiJ7ey5mbmFtZX19X291dHB1dHt7LmV4dH19In0=", 
                "input_from": "A", 
                "result": {
                    "code": 0, 
                    "desc": "successfully completed", 
                    "has_output": true, 
                    "kodo_file": {
                        "bucket": "st-qtest-out", 
                        "hash": "Fu4szUcZD6cREejZwUoYV-YHW3j_", 
                        "key": "foreman_output.mp4"
                    }
                }
            }, 
            "id": "B"
        }
    ], 
    "pipeline": "1380480140.default.sys", 
    "reqid": "lYcAABEVjBclRFcW", 
    "version": "v3"
}

    响应状态码

    HTTP状态码 含义
    200 查询成功
    400 请求报文格式错误
    401 签名验证不通过
    404 查询对象不存在
    599 服务端操作失败如遇此错误，请将完整错误信息（包括所有HTTP响应头部）提交工单 给我们。
    以上内容是否对您有帮助？
    • Qvm free helper
    Close