批量修改文件保存期限
更新时间：2020-10-08 22:21:24
描述
该接口为异步接口，可以批量修改指定空间下的所有文件或指定目录下的文件的保存期限
注：相同文件的保存期限以覆盖的方式设置。
请求说明
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 | 否 | 指定前缀，即目录名<UrlsafeBase64_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"
本篇文档内容对您是否有帮助？
有帮助
我要反馈