设置Bucket的生命周期
更新时间：2021-12-29
接口说明
本接口用来创建生命周期管理规则。
说明
只有bucket的owner且拥有FULL_CONTROL权限才能够进行此请求。
请求URI
PUT /v1/{bucketName}/?lifecycle
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 | 参数位置 |
|---|---|---|---|---|---|
| bucketName | String | 是 | bucket的名称 | "bucketName_example" | Path |
请求体参数
请求体字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| rule | List<Rule> | 是 | 规则的列表 |
Rule字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| id | String | 是 | 规则的标识符 | rule-id |
| status | String | 是 | 规则的状态。 | enabled |
| resource | List<String> | 是 | 规则对哪些资源生效。 | |
| condition | Condition | 是 | 规则依赖的条件 | |
| action | Action | 是 | 对resource执行的操作动作。 |
Condition字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| time | Time | 否 | 时间限制条件。 |
Time字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| dateGreaterThan | String | 否 | 描述时间关系。 | 2016-09-07T00:00:00Z |
Action字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| name | String | 是 | 执行的操作名称。 | DeleteObject |
| storageClass | String | 否 | Object的存储类型 |
响应体参数
响应体字段数据结构说明
请求示例
PUT /v1/bucketName_example/?lifecycle
<公共请求头>
{
"rule" : [ {
"condition" : {
"time" : {
"dateGreaterThan" : "2016-09-07T00:00:00Z"
}
},
"resource" : [ "bucket/prefix/*" ],
"action" : {
"storageClass" : "storageClass",
"name" : "DeleteObject"
},
"id" : "rule-id",
"status" : "enabled"
} ]
}响应示例
HTTP/1.1 200 OK
<公共响应头>
{ }错误码
请参考通用错误码