状态查询
用户可以使用<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 且指定的bucket :key 存在,则返回1 ,告诉用户返回的是旧数据。 |
pipeline | string | 云处理操作的处理队列,默认使用队列为共享队列0.default 。 |
reqid | string | 云处理请求的请求id,主要用于七牛技术人员的问题排查。 |
type | number | 1 表示闲时任务,无type表示普通任务。 |
- 如果请求失败,返回包含如下内容的JSON字符串(已格式化,便于阅读):
{
"error": "<ErrMsg string>"
}
响应状态码
HTTP状态码 | 含义 |
---|---|
200 | 查询成功 |
400 | 请求报文格式错误 |
612 | 查询对象不存在 |
599 | 服务端操作失败 如遇此错误,请将完整错误信息(包括所有HTTP响应头部)提交工单 给我们。 |
文档反馈
(如有产品使用问题,请 提交工单)