Appearance
GetBucketLifecycle
接口描述
此接口用于获取定义的生命周期管理规则详细信息。
请求（Request）
请求语法
GET /<BucketName>?lifecycle HTTP/1.1
Host: fos.flymeyun.com
Date: date请求头域
无特殊参数
请求参数
无特殊参数
响应（Response）
请求参数
| 规则项 | 描述 | 是否必填 | 备注 |
|---|---|---|---|
| rule | 规则的列表 | 必填 | 所有规则的列表 |
| +id | 规则的标识符。 | 必填 | 同一个bucket内规则id必须唯一，不能重复。如果用户不填系统会自动帮用户生成一个。 |
| +status | 规则的状态。 | 必填 | 取值为enabled或disabled，当规则处于disabled时规则不生效。 |
| +resource | 规则对哪些资源生效。 | 必填 | 举例：对samplebucket里以prefix/为前缀的Object生效：samplebucket/prefix/；对samplebucket里所有Object生效：samplebucket/。 |
| +condition | 规则依赖的条件。 | 选填 | 目前只支持time形式，基础生命周期规则下为必填项。 |
| +time | 时间限制条件。 | 选填 | 通过定义的dateGreaterThan实现 |
| ++dateGreaterThan | 描述时间关系。 | 必填 | 支持绝对时间date和相对时间days。绝对时间date格式为yyyy-mm-ddThh:mm:ssZ，eg. 2016-09-07T00:00:00Z。绝对时间为UTC时间, 必须以00:00:00(UTC 0点)结尾；相对时间days的描述遵循ISO8601, 支持的最小时间粒度为天，如: $(lastModified)+P7D表示的时间为object的last-modified之后7天。 |
| action | 对resource执行的操作动作。 | 选填 | 基础生命周期规则下为必填项。 |
| +name | 执行的操作名称。 | 必填 | 取值为DeleteObject、AbortMultipartUpload。 |
响应元素
无特殊元素
响应头域
无特殊头域
注意事项
- 如果请求的源Bucket不存在，返回404错误，错误码为NoSuchBucket。
- 如果请求的源Bucket没有配置lifecycle，返回404错误，错误码为NoLifecycleConfiguration。
基础生命周期请求示例
请求示例
GET /<BucketName>?lifecycle HTTP/1.1
Host: fos.flymeyun.com
Date: Thu, 15 Sep 2016 00:16:26 GMT响应示例
HTTP/1.1 200 OK
Date: Thu, 15 Sep 2016 00:17:23 GMT
x-fos-request-id: 1a5fd81e-626b-45b3-a885-15fff9cd106c
Connection: keep-alive
Content-Length: 358
{
"rule": [
{
"id": "sample-rule-delete-prefix",
"status": "enabled",
"resource": [
"bucket/prefix/*"
],
"condition": {
"time": {
"dateGreaterThan": "2016-09-07T00:00:00Z"
}
},
"action": {
"name": "DeleteObject"
}
},
{
"id": "sample-rule-abort-multiupload-prefix",
"status": "enabled",
"resource": [
"bucket/prefix/*"
],
"condition": {
"time": {
"dateGreaterThan": "$(lastModified)+P7D"
}
},
"action": {
"name": "AbortMultipartUpload"
}
}
]
}