批量修改文件保存期限


描述

该接口为异步接口,可以批量修改指定空间下的所有文件或指定目录下的文件的保存期限
注:相同文件的保存期限以覆盖的方式设置

请求说明

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

头部说明

参数 必填 描述
Host 管理域名
Authorization 管理凭证

参数说明

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

fops =bucket/<Urlsafe_Base64_Encoded_Bucket>/deadline/<deadline>;bucket/<Urlsafe_Base64_Encoded_Bucket>/prefix/<Urlsafe_Base64_Encoded_prefix>/deadline/<deadline>&notifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&separate=<Separate>
参数 必填 描述
fops 处理参数列表,格式为上述说明,支持同时请求多个处理,参数列表之间用 ; 分隔
bucket 指定空间名;<Urlsafe_Base64_Encoded_bucket>为对指定Bucket名称进行URL安全的Base64编码后的字符串
prefix 指定前缀,即目录名<Urlsafe_Base64_Encoded_prefix>为对指定前缀进行URL安全的Base64编码后的字符串。注:1、prefix不为空时,表明对该目录下的所有文件生效,当prefix为空时,表明对指定空间里的所有文件生效。 2、不支持模糊匹配。如指定前缀为test,则key前缀为test123的资源不会生效
deadline 设置文件多少天后删除,单位:天。例如:1、2、3…… 注:0表示尽快删除,-1表示取消过期时间,永久保存
notifyURL 处理结果通知接收URL
请求参数示例
fops=bucket/bXlidWNrZXQ=/prefix/YWFjLw==/deadline/10;bucket/bXlidWNrZXQ=/prefix/YWFiLw==/deadline/30&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=/prefix/YWFjLw==/deadline/10;bucket/bXlidWNrZXQ=/prefix/YWFiLw==/deadline/30&notifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/setdeadline"