批量修改文件保存期限
更新时间：2025-08-18 15:32:48
此接口是一个异步接口，可以批量修改指定空间中的所有文件或指定目录中文件的保留期限。
注意：相同文件的保留期限通过覆盖的方式设定。
请求描述
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>¬ifyURL=<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¬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=/prefix/YWFjLw==/deadline/10;bucket/bXlidWNrZXQ=/prefix/YWFiLw==/deadline/30¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/setdeadline"
本篇文档内容对您是否有帮助？
有帮助
我要反馈