删除m3u8文件

更新时间:2025-08-18 15:32:46

此接口用于删除指定资源。

注意:

  • 删除的文件无法恢复,请谨慎操作。
  • 在删除过程中,部分ts文件的删除可能会失败。如收到删除失败通知,需重新触发m3u8文件的删除,直至成功。

请求描述

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

Header 描述

参数 是否必需 描述
HOST 管理域名,可在控制台空间概览界面获取。
Authorization 管理凭证

参数描述

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

fops=bucket/<Urlsafe_Base64_Encoded_bucket>/key/<Urlsafe_Base64_Encoded_key>/deletets/<deletets>&notifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&separate=<Separate>
参数 是否必需 描述
fops 处理参数列表,格式如上所述,同时支持多个处理请求。参数列表用 ; 分隔。
注意:当指定资源不存在时,返回结果为“删除成功”。
bucket 指定存储空间。<Urlsafe_Base64_Encoded_bucket>为指定空间名的URL安全Base64编码字符串。
key 指定存储资源的文件名。<Urlsafe_Base64_Encoded_key>为指定资源文件名的URL安全Base64编码字符串。
deletets 指定是否关联删除ts文件。
0: 不进行关联删除
1: 删除关联的ts文件
注意:<1>若未设置此参数,则默认进行关联删除 <2>仅对TS访问路径为相对路径的m3u8文件格式有效,若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&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=/key/SW1hZ2UubTN1OA==/deletets/1;bucket/bXlidWNrZXQ=/key/SW1hZ2UxLm0zdTg=/deletets/0&notifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/deletem3u8"
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!