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

状态查询

最近更新时间: 2024-11-20 16:02:19

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

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

接口规格

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/aac/acodec/libfdk_aac/ab/64k|vsample/png/s/123x/interval/3/ss/60/savePattern/JHtzYXZlYXMuYnVja2V0fS0kKGNvdW50KQ==|saveas/ZHV0ZXN0/savePattern/ZWNobw==",
            "code": 3,
            "desc": "The fop is failed",
            "error": "execute fop cmd failed: not a valid video",
            "errorIndex": 1,
            "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"
    "type": "1"
    "taskFrom": "workflow:mp4-transcode"
}

字段名称	类型	说明
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	如果处理失败，该字段会给出失败的详细原因。
errorIndex	string	如果处理失败，该字段会给出错误的管道顺序，从0开始，0表示第一段，以此类推。
hash	string	云处理结果保存在服务端的唯一`hash`标识。
key	string	云处理结果的外链资源名`Key`。
returnOld	number	默认为0。当用户执行`saveas`时，如果未加`force`且指定的`bucket`：`key`存在，则返回1 ，告诉用户返回的是旧数据。
pipeline	string	云处理操作的处理队列，默认使用队列为共享队列`0.default`。
reqid	string	云处理请求的请求id，主要用于七牛技术人员的问题排查。
type	number	任务类型，包括2种类型。 1. `1`：表示闲时任务，在创建任务时开启闲时； 2. `无type`：表示普通任务。
taskFrom		任务来源，包括2种来源。 1. API创建： a.`无taskFrom`：表示通过API+fops命令创建的任务； b. `workflow:workflowID`：表示通过 API+工作流模板创建的任务； 2.触发器创建 `tigger:tiggerID`：表示通过触发器创建的任务。

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

{
    "error":   "<ErrMsg    string>"
}

响应状态码

HTTP状态码	含义
200	查询成功
400	请求报文格式错误
612	查询对象不存在
599	服务端操作失败如遇此错误，请将完整错误信息（包括所有HTTP响应头部）提交工单给我们。

以上内容是否对您有帮助？