更新时间:2025-08-18 15:32:46
此接口用于删除指定资源。
注意:
- 删除的文件无法恢复,请谨慎操作。
- 在删除过程中,部分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>为指定空间名的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¬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"