删除m3u8文件
更新时间：2020-10-08 22:21:23
描述
该接口提供删除指定资源。
注：
- 文件删除后不可恢复，请谨慎操作。
- 删除过程中，可能出现某些ts文件删除失败的情况,如果收到删除失败的通知，需要重新触发删除该m3u8文件，直至成功。
请求说明
POST /fmgr/deletem3u8
HOST: <MgrDomain>
Authorization:<accessToken>
头部说明
| 参数 | 必填 | 描述 |
|---|---|---|
| Host | 是 | 管理域名，可在用户管理界面获取 |
| Authorization | 是 | 管理凭证 |
参数说明
请求参数以如下格式组织，作为请求内容提交：
fops=bucket/<Urlsafe_Base64_Encoded_bucket>/key/<Urlsafe_Base64_Encoded_key>/deletets/<deletets>¬ifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&separate=<Separate>
| 参数 | 必填 | 描述 |
|---|---|---|
| fops | 是 | 处理参数列表，格式为上述说明，支持同时请求多个处理，参数列表之间用 ; 分隔。注：指定的资源不存在时，返回结果为“删除成功”。 |
| bucket | 是 | 指定存储空间。<Urlsafe_Base64_Encoded_bucket>为对指定Bucket名称进行URL安全的Base64编码后的字符串。 |
| key | 是 | 指定存储资源的key。<Urlsafe_Base64_Encoded_key>为对指定资源的key进行URL安全的Base64编码后的字符串。 |
| deletets | 否 | 指定是否进行关联删除ts文件。0 不进行关联删除；1 删除关联的ts文件。注：<1>若未设置该参数，默认进行关联删除<2>仅对m3u8文件格式中TS访问路径为相对路径的文件生效，若TS地址为绝对路径，TS文件不会进行关联删除，请谨慎操作<3>针对TS文件为绝对路径的m3u8文件格式，建议先解析m3u8文件内容对TS文件单独进行操作后再对m3u8文件进行处理 |
| notifyURL | 否 | 处理结果通知接收URL，通知内容格式见任务查询接口的返回内容。 |
| separate | 否 | 处理指令是否分开通知。设置1和0作为选项码：1：表示每个指令执行完后都通知notifyURL。0：表示所有指令执行完后再一次性通知notifyURL。默认值为0。 |
fops参数示例
fops=bucket/bXlidWNrZXQ=/key/SW1hZ2UubTN1OA==/deletets/1;bucket/bXlidWNrZXQ=/key/SW1hZ2UxLm0zdTg=/deletets/0¬ifyURL=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=/key/SW1hZ2UubTN1OA==/deletets/1;bucket/bXlidWNrZXQ=/key/SW1hZ2UxLm0zdTg=/deletets/0¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/deletem3u8"
本篇文档内容对您是否有帮助？
有帮助
我要反馈