按前缀删除资源

描述

该接口提供删除符合指定前缀的资源。
注:1.文件删除后不可恢复,请谨慎操作。2.如果删除m3u8文件不会同时删除ts文件,如需关联删除可使用删除m3u8文件接口

请求说明

POST /fmgr/deletePrefix
HOST: <MgrDomain>
Authorization:<accessToken>

头部说明

参数 必填 描述
HOST 管理域名,可在用户管理界面获取
Authorization 管理凭证

参数说明

请求参数以如下格式组织,作为请求内容提交:

fops=bucket/<Urlsafe_Base64_Encoded_bucket>/prefix/<Urlsafe_Base64_Encoded_prefix>/output/<Urlsafe_Base64_Encoded_output>&notifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&separate=<Separate>
参数 必填 描述
fops 处理参数列表,格式为上述说明,支持同时请求多个处理,参数列表之间用 ; 分隔。
注:指定的资源不存在时,返回结果为“删除成功”。
bucket 指定存储空间。
<Urlsafe_Base64_Encoded_bucket>为对指定Bucket名称进行URL安全的Base64编码后的字符串。
prefix 指定前缀,即目录名
<Urlsafe_Base64_Encoded_prefix>为对指定前缀进行URL安全的Base64编码后的字符串。
注:不支持模糊匹配。如指定前缀为test,则key前缀为test123的资源不会被删除。
output 将任务处理结果的描述信息保存到指定文件,默认不保存。格式为:<bucket>:<key>。
<Urlsafe_Base64_Encoded_output>为对指定output进行URL安全的Base64编码后的字符串。
注:多个操作指定的output相同的话,旧的output会被新的output覆盖掉。
notifyURL 处理结果通知接收URL,需要使用URL安全的Base64编码,通知内容格式见任务查询接口的返回内容。
separate 处理指令是否分开通知。设置1和0作为选项码:
1:表示每个指令执行完后都通知notifyURL
0:表示所有指令执行完后再一次性通知notifyURL
默认值为0。

注:指定output后,output文件逐行记录如下信息:(各字段间用制表符分隔)

<code>  <desc>  <bucket>    <Urlsafe_Base64_Encoded_key>    <Id>
字段名 描述
id 任务进程ID,即接口响应的persistentId。
code 任务状态码:0成功,1失败。
desc 与状态码对应的描述。
bucket 空间名。
Urlsafe_Base64_Encoded_key 对资源的key进行URL安全的Base64编码后的字符串。

fops参数示例

fops=bucket/bXlidWNrZXQ=/prefix/YWFjLw==;bucket/bXlidWNrZXQ=/prefix/YWFiLw==&notifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1

响应说明

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

{ "persistentId": <persistentId> }
字段名 必填 描述
persistentId 任务进程ID,可以用于查询任务进度。

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

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

范例

curl -v -X POST -d "fops=bucket/bXlidWNrZXQ=/prefix/YWFjLw==&notifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/deletePrefix"