批量设置bucket生命周期管理配置
更新时间：2022-08-24
接口描述
该接口会以参数中的规则替换指定bucket中所有生命周期管理规则。当前仅支持以前缀的方式匹配bucket中文件，设置过期删除时间。
注意事项 同一配置文件中不允许出现ID相同的规则，也不允许出现prefix相同的规则。
请求结构
PUT /v1/bos/bucket/lifecycle/{bucketId} HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| bucketId | String | 是 | URL参数 | Bucket的ID，全局唯一，由系统自动生成，由“bkt-” 和随机字符串组成 |
| ruleList | LifecycleConfiguration | 是 | requestBody参数 | 规则列表 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| result | Boolean | 操作是否成功 |
| action | String | 操作 |
错误码
请参照错误返回章节的内容。
请求示例
PUT https://bec.baidubce.com/v1/bos/bucket/lifecycle/bkt-1jvgk6ue HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"ruleList": [
{
"id": "test2",
"status": "Enabled",
"prefix": "test/",
"expirationInDays": 1,
},
{
"id": "test3",
"status": "Enabled",
"prefix": "test2/",
"expirationDate": "2021-05-22T00:00:00Z"
}
]
}响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
"result": true,
"action": "setBucketLifecycleConfiguration"
}Model
LifecycleConfiguration
| 参数名称 | 类型 | 描述 |
|---|---|---|
| ruleList | List<BucketRule> | 生命周期管理规则列表 |
BucketRule
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | String | 规则ID，同一配置内不能重复 |
| status | String | 规则状态，可选值:Enabled，Disabled |
| prefix | String | 文件名前缀，规则会匹配bucket内符合此前缀的所有文件。同一配置内前缀不能重复。为空（“”）时，对整个bucket生效，以“/”结尾时对部分路径生效 |
| expirationInDays | int | 过期删除天数（与expirationDate不可同时设置） |
| expirationDate | Date | 指定日期删除，与expirationInDays不可同时设置） |