设置文件保存期限

描述

该接口支持用户设置文件的保存期限,超过设置的天数文件自动删除。
注:文件删除后不可恢复,请谨慎操作。

请求说明

 POST /setdeadline
 Host: <MgrDomain>
 Authorization:<AccessToken>

 <requestParam>

头部说明

参数 必填 描述
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>仅对m3u8文件格式中TS访问路径为相对路径的文件生效,若TS地址为绝对路径,TS文件不会进行关联设置,请谨慎操作
<3>针对TS文件为绝对路径的m3u8文件格式,建议先解析m3u8文件内容对TS文件单独进行操作后再对m3u8文件进行处理

响应说明

返回如下内容的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"