获取Bucket的生命周期管理规则
更新时间：2021-12-29
接口说明
此接口用于获取定义的生命周期管理规则详细信息。
注意事项
- 如果请求的源Bucket不存在，返回404错误，错误码为NoSuchBucket。
- 如果请求的源Bucket没有配置lifecycle，返回404错误，错误码为NoLifecycleConfiguration。
请求URI
GET /v1/{bucketName}/?lifecycle
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 | 参数位置 |
|---|---|---|---|---|---|
| bucketName | String | 是 | bucket的名称 | "bucketName_example" | Path |
请求体参数
请求体字段数据结构说明
响应体参数
响应体字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| rule | List<Rule> | 所有规则的列表 |
Rule字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| id | String | 规则的标识符 | sample-rule-abort-multiupload-prefix |
| status | String | 规则的状态。 | enabled |
| resource | List<String> | 规则对哪些资源生效。 | |
| condition | Condition | 规则依赖的条件。 | |
| action | Action | 对resource执行的操作动作。 |
Condition字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| time | Time | 时间限制条件。 |
Time字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| dateGreaterThan | String | 描述时间关系。 | $(lastModified)+P7D |
Action字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| name | String | AbortMultipartUpload | |
| storageClass | String | STANDARD_IA |
请求示例
JSON
1GET /v1/bucketName_example/?lifecycle
2<公共请求头>
3
4
5{ }响应示例
JSON
1HTTP/1.1 200 OK
2<公共响应头>
3
4{
5 "rule" : [ {
6 "condition" : {
7 "time" : {
8 "dateGreaterThan" : "$(lastModified)+P7D"
9 }
10 },
11 "resource" : [ "bucket/prefix/*", "bucket/prefix/*" ],
12 "action" : {
13 "storageClass" : "STANDARD_IA",
14 "name" : "AbortMultipartUpload"
15 },
16 "id" : "sample-rule-abort-multiupload-prefix",
17 "status" : "enabled"
18 }, {
19 "condition" : {
20 "time" : {
21 "dateGreaterThan" : "$(lastModified)+P7D"
22 }
23 },
24 "resource" : [ "bucket/prefix/*", "bucket/prefix/*" ],
25 "action" : {
26 "storageClass" : "STANDARD_IA",
27 "name" : "AbortMultipartUpload"
28 },
29 "id" : "sample-rule-abort-multiupload-prefix",
30 "status" : "enabled"
31 } ]
32}错误码
请参考通用错误码