更新时间: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文件。 注:如不含解压缩的操作,该字段为空。 |