文档中心 对象存储 任务通知&查询

任务通知&查询

更新时间:2023-08-17 17:36:13

高级资源管理的任务使用异步方式执行,任务执行完成支持主动通知,也支持主动查询任务状态

任务通知

1、如您下发任务时有指定notifyURL,任务结束后会主动往该地址发送通知。
2、通知请求会配置连接超时20s、请求超时60s。
3、通知内容使用安全base64编码,收到内容后需要先做base64解码后再使用json解析内容。

通知安全机制

网宿云存储会在回调的请求头中,加入Authorization字段。

格式:

<Accesskey>:<Urlsafe_Base64_Encode(hmac_sha1(callBackUrlWithQuery+"\n"+urlsafe_base64_encode(callbackBody),SecretKey))>

范例:
d0e56f9f4a75267eba123348f839fbedcd9464c6:OTQzNzU5YWVjOTZlNTRlMWIwYmQzZTA2ZDhjMTFhOWEyNGM1ZjIzZg==

通知重试机制

上传回调失败时,默认连续重试3次,而后每隔1分钟重试一次(重试5次),共重试8次。

如果重试后回调成功,则返回正常的回调应答,状态码为200。
如果重试后回调服务器仍无正常响应,则返回异常的回调应答,状态码为579。

通知实例

POST www.test-notify.com
Authorization:f4880395bc1624277f0cf1ee2d6d332fbc1ef11b:NGEyMDVjMDc1NTlkNTE3NDRhMzI3YmFjMzdlOGQ5NzRjNWUyYmE1OQ==
content-length: 652
content-type: text/plain; charset=UTF-8
host: www.test-notify.com
connection: Keep-Alive
user-agent: Apache-HttpClient/4.5.12 (Java/1.8.0_242)
accept-encoding: gzip,deflate

eyJpZCI6IjIwMTA1NDY0NTQwZjE5NzQxNGQ1MWE4NjEyNDBkOTIxZWYyMDYiLCJjb2RlIjozLCJkZXNjIjoiZmlsZU9wZXJhdGVTdWNjZWVkIiwic2VwYXJhdGUiOjAsIml0ZW1zIjpbeyJjbWQiOiJyZXNvdXJjZS9kSEpoYm5OamIyUmxNVEExT25SbGMzUmZjM0pqWDJacGJHVmZNVFk1TVRrM09ESTFNVEUyTmk1dGNEUT0vYnVja2V0L2R5MTBjbUZ1YzJOdlpHVXRjbVZuYVc5dU1UQTEva2V5L2RHVnpkRjl6Y21OZlptbHNaVjh4TmpreE9UYzRNalV4TVRZMkxtMXdOQT09IiwiY29kZSI6MywiZGVzYyI6ImZpbGVPcGVyYXRlU3VjY2VlZCIsImVycm9yIjpudWxsLCJoYXNoIjoibGo2Tkg4Q0V1dUNLZDJmQm94ZTJGSmxybDVsVCIsImZzaXplIjo2NDM3ODM2LCJrZXkiOiJ0ZXN0X3NyY19maWxlXzE2OTE5NzgyNTExNjYubXA0IiwidXJsIjoiaHR0cDovL3ctdHJhbnNjb2RlLXJlZ2lvbjEwNS5jb20vdGVzdF9zcmNfZmlsZV8xNjkxOTc4MjUxMTY2Lm1wNCJ9XX0=

任务查询

该接口提供查询高级资源管理(Fmgr)任务的执行情况。

请求说明

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

参数说明

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

如果请求成功,将返回任务内容;如请求失败,将返回如下内容的Json串:

{
    "code":"<httpCode  int>", 
    "message":"<errMsg string>"
}
字段名 必填 描述
code HTTP请求响应码,参见HTTP响应状态码
message 请求失败的提示信息。

范例

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

通知&查询内容说明

如果请求成功,则返回如下内容的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文件。
注:如不含解压缩的操作,该字段为空。
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!