任务查询

文档中心

Fmgr任务查询

描述

该接口提供查询Fmgr任务的执行情况。
注：notifyURL收到的Fmgr任务通知内容的格式与该接口响应内容的格式一致。

请求说明

GET /fmgr/status?persistentId=<persistentId>
HOST: <MgrDomain>

参数说明

参数	必填	描述
persistentId	是	任务进程ID。

响应说明

如果请求成功，则返回如下内容的Json串:

{
  "id": "<id string>",
  "code": <code int>,
  "desc": "<desc string>",
  "separate": "<separate string>",
  "items": [
    {
      "cmd": "<cmd string>",
      "code": "<code string>",
      "desc": "<desc string>",
      "error": "<error string>",
      "hash": "<hash string>",
      "fsize": "<fsize int>",
      "key": "<key string>",
      "url": "<url string>"
      "decompresslist": "<list string>"
    }
  ]
}

字段名	类型	描述
id	string	任务进程ID，即Fmgr接口响应的persistentId。
code	int	1、若为查询接口获取的信息，表示任务状态码：`0`待处理中，`1`处理中，`3`处理完成，`4`通知中，`5`通知失败，`6`通知成功； 2、若为通知接口获取的信息，表示通知状态，`1`分开通知，有任务处理中，`2`分开通知，有任务处理失败，`3`表示通知成功
desc	string	与状态码相应的详细描述
separate	string	分开通知选项，`0`表示一次性通知，`1`表示分开通知。
items	array	每个操作的状态信息。如果处理请求包括多个操作，则items包含多条信息。
cmd	string	操作命令（fops）
code	string	处理结果状态码，`0`待处理中，`1`处理中，`2`处理失败，`3`处理成功，`4`处理成功通知中，`5`处理成功通知失败，`6`处理成功通知成功，`18`处理失败通知中，`19`处理失败通知失败，`20`处理失败通知成功，其他(具体情况，请联系云存储工作人员) 注：使用“删除m3u8文件”接口删除m3u8文件失败，可能存在部分TS已删除，若需要完全删除，请再次发起m3u8关联删除操作
desc	string	与状态码相应的详细描述
error	string	如果处理失败，该字段列出具体原因
fsize	int	处理后的文件大小。注：如果是按前缀删除任务，该字段为空。
hash	string	处理结果的`hash`值注：如果是按前缀删除任务，该字段为空。
key	string	处理结果的`key`值注：如果是按前缀删除任务，该字段为指定的output；未指定output，则该字段为空。
url	string	资源的访问路径注：如果是按前缀删除任务，该字段为指定的output 访问URL；未指定output，则该字段为空。
decompresslist	string	解压缩后自动生成的list文件注：如不含解压缩的操作，该字段为空。

如果请求失败，则返回如下内容的Json串:

{
    "code":"<httpCode  int>",
    "message":"<errMsg string>"
}

字段名	必填	描述
code	是	HTTP请求响应码，参见HTTP响应状态码<返回码>
message	是	请求失败的提示信息。

范例

curl -v http://mgrDomain/fmgr/status?persistentId=ff80808149deceff014a7090b6700000