智能多媒体服务

  • 智能多媒体服务 > API 文档 > 数据处理机制 >持久化处理(pfop) >状态查询

    状态查询

    最近更新时间: 2024-09-05 11:22:02

    用户可以使用<persistentId>来主动查询持久化处理(prefop)的执行状态。

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

    接口规格

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

    请求报文

    服务端按顺序完成所有指定的云处理操作后,会将处理结果状态提交到<persistentNotifyUrl>指向的网址。

    请求语法

    GET /status/get/prefop?id=<persistentId> HTTP/1.1
    Host: api.qiniu.com  
    

    头部信息

    头部名称 必填 说明
    Host 固定为api.qiniu.com

    响应报文

    响应语法

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

    头部信息

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

    响应内容

    • 如果请求成功,返回包含如下内容的JSON字符串(已格式化,便于阅读):
    {
        "id": "16864pauo1vc9nhp12",
        "code": 0,
        "creationDate": "2024-08-27T19:02:44.664312968+08:00",
        "desc": "The fop was completed successfully",
        "inputKey": "sample.mp4",
        "inputBucket": "dutest",
        "items": [
            {
                "cmd": "avthumb/mp4/r/30/vb/256k/vcodec/libx264/ar/22061/ab/64k/acodec/libmp3lame",
                "code": 0,
                "desc": "The fop was completed successfully",
                "error": "",
                "hash": "FrPNF2qz66Bt14JMdgU8Ya7axZx-",
                "key": "v-PtT-DzpyCcqv6xNU25neTMkcc=/FjgJQXuH7OresQL4zgRqYG5bZ64x",
                "returnOld": 0
            },
            {
                "cmd": "avthumb/iphone_low",
                "code": 0,
                "desc": "The fop was completed successfully",
                "error": "",
                "hash": "FmZ5PbHMYD5uuP1-kHaLjKbrv-75",
                "key": "tZ-w8jHlQ0__PYJdiisskrK5h3k=/FjgJQXuH7OresQL4zgRqYG5bZ64x",
                "returnOld": 0
            },
            {
                "cmd": "avthumb/m3u8/noDomain/1/r/30/vb/256k/vcodec/libx264/ar/22071/ab/64k/acodec/libmp3lame",
                "code": 0,
                "desc": "The fop was completed successfully",
                "error": "",
                "hash": "Fi4gMX0SvKVvptxfvoiuDfFkCuEG",
                "key": "8ehryqviSaMIjkVQDGeDcKRZ6qc=/FjgJQXuH7OresQL4zgRqYG5bZ64x",
                "returnOld": 0
            },
            {
                "cmd": "avthumb/m3u8/noDomain/1/vb/440k",
                "code": 0,
                "desc": "The fop was completed successfully",
                "error": "",
                "hash": "FtuxnwAY9NVBxAZLcxNUuToR9y97",
                "key": "s2_PQlcIOz1uP6VVBXk5O9dXYLY=/FjgJQXuH7OresQL4zgRqYG5bZ64x",
                "returnOld": 0
            }
        ],
        "pipeline": "0.default",
        "reqid": "ffmpeg.3hMAAH3p5Gupb6oT"
    }
    
    字段名称 类型 说明
    id number 持久化处理的进程ID,即前文中的<persistentId>
    code number 状态码0成功,1等待处理,2正在处理,3处理失败。
    creationDate string 云处理请求的提交时间。
    desc string 与状态码相对应的详细描述。
    inputKey string 处理源文件的文件名。
    inputBucket string 处理源文件所在的空间名。
    items array 云处理操作列表,包含每个云处理操作的状态信息。
    cmd string 所执行的云处理操作命令fopN
    error string 如果处理失败,该字段会给出失败的详细原因。
    hash string 云处理结果保存在服务端的唯一hash标识。
    key string 云处理结果的外链资源名Key
    returnOld number 默认为0。当用户执行saveas时,如果未加force且指定的bucketkey存在,则返回1 ,告诉用户返回的是旧数据。
    pipeline string 云处理操作的处理队列,默认使用队列为共享队列0.default
    reqid string 云处理请求的请求id,主要用于七牛技术人员的问题排查。
    type number 1表示闲时任务,无type表示普通任务。
    • 如果请求失败,返回包含如下内容的JSON字符串(已格式化,便于阅读):
    {
        "error":   "<ErrMsg    string>"
    }
    

    响应状态码

    HTTP状态码 含义
    200 查询成功
    400 请求报文格式错误
    612 查询对象不存在
    599 服务端操作失败

    如遇此错误,请将完整错误信息(包括所有HTTP响应头部)提交工单 给我们。

    以上内容是否对您有帮助?
  • Qvm free helper
    Close