设置文件保存期限
更新时间：2025-08-18 15:32:21
此接口允许用户设置文件的保留期限，超过设定天数的文件将被自动删除。
注意：文件删除后无法恢复，请谨慎操作。
请求描述
请求路径
POST /setdeadline
Host: <MgrDomain>
Authorization:<AccessToken>
<requestParam>
Header 描述
| 参数 | 是否必需 | 描述 |
|---|---|---|
| Host | 是 | 管理域名，可在控制台空间概览界面获取。 |
| Authorization | 是 | 管理凭证。 |
请求参数
请求参数按以下格式组织，并作为请求内容提交：
bucket=<Urlsafe_Base64_Encoded_Bucket>&key=<Urlsafe_Base64_Encoded_Key>&deadline=<deadline>&relevance=<relevance>
请求参数描述
| 参数 | 是否必需 | 描述 |
|---|---|---|
| bucket | 是 | 空间名称。 |
| key | 是 | 文件名称。 |
| deadline | 是 | 文件保留期限。保存时间超过多少天的文件将自动删除，单位：天。例如：1，2，3… 注意：0表示尽快删除，-1表示取消过期时间并永久保存。 |
| relevance | 否 | 是否与m3u8文件的操作关联设置TS文件的存储期限。0 表示不关联设置，1 表示关联设置。 注意： 1. 如果不设置此参数，则默认为关联操作。如果是非m3u8文件，此参数不生效。 2. 仅对TS访问路径为m3u8文件格式的相对路径的文件生效。如果TS地址为绝对路径则TS文件不会关联设置。请谨慎操作。 3. 对于TS文件是m3u8文件格式中的绝对路径，建议在处理m3u8文件前解析m3u8文件的内容并单独操作TS文件。 |
响应描述
返回一个包含以下内容的 JSON 字符串：
{
"code": "<code string>",
"message": "<message string>"
}
| 字段名称 | 是否必需 | 描述 |
|---|---|---|
| code | 是 | 有关HTTP请求响应代码，请参见 HTTP响应状态码。 |
| message | 是 | 请求提示信息。OK表示成功。 |
示例
curl -v -X POST -d"bucket=aW1hZ2Vz&key=bGVodS5tcDQ==&deadline=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/setdeadline"
本篇文档内容对您是否有帮助？
有帮助
我要反馈