帮助与文档
搜索
- 云服务器
- 弹性IP
- VPC
- CDN
- IAM
最近更新时间：2020-01-13 17:43:34
此GET操作返回bucket的lifecyle配置, 即描述各条Rule的一个xml。
使用此接口，只有bucket的所有者有权限操作。
GET /?lifecycle HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}注意：
本接口不使用请求参数。
只使用常用请求头部。获取更多信息，请点击常用请求头部。
不使用请求内容。
只带有常用响应头部。获取更多信息，请点击常用响应头部。
返回一个xml，可能有下列节点：
| 名称 | 描述 | 是否必须 |
|---|---|---|
| LifecycleConfiguration | 包含一堆Rule的容器, 一个Bucket最多100条Rule。 类型：Container 子节点: Rule 父节点：无 |
是 |
| Rule | 包含一条规则 类型：Container 父节点：LifecycleConfiguration |
是 |
| ID | Rule的唯一标识, 一个Bucket内ID不能重复。ID长度<=255字符，注意是utf8编码字符，不是字节 类型：String 父节点：Rule |
是 |
| Filter | 规定前缀，一个Rule只能有一个Filter, 不同rule的prefix不能冲突。 类型：Container 子节点：Prefix 父节点：Rule |
否 |
| Prefix | 符合这个前缀的object才会被删。一个Rule只能有一个Filter和一个Prefix 类型：String 父节点：Filter |
否 |
| Status | Enabled状态，该Rule就定期被执行；Disabled，该Rule被忽略，但该Rule随时能被Enable而不是被删。 类型：String 父节点：Rule 取值: Enabled, Disabled |
是 |
| Expiration | 规定对应的object何时被删。 类型：Container 子节点：Days，Date 父节点：Rule |
是 |
| Date | last modify day<这个数的object被删。必须是ISO 8601格式的北京时间。时分秒必须填0，即必须是0点。 类型：String 父节点: Expiration |
是，如果没有Days |
| Days | 规定一个正数，对应object在last modify多少天之后被删。 类型: 整数 父节点: Expiration |
是，如果没有Date |
| Error Code | 描述 | HTTP Status Code |
|---|---|---|
| NoSuchLifecycleConfiguration | 此bucket没有lifecycle配置 | 404 Not Found |
请求示例
GET /?lifecycle HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyun.com
Date: Wed, 01 Mar 2016 12:00:00 GMT
Authorization: authorization string响应示例
HTTP/1.1 200 OK
Date: Wed, 01 Mar 2016 12:02:00 GMT
Content-Length: 124
Server: Tengine
x-kss-request-id: 54a47bda18ac4e6e91de369add54218e
<LifecycleConfiguration>
<Rule>
<ID>id1</ID>
<Filter>
<Prefix>documents/</Prefix>
</Filter>
<Expiration>
<Date>2016-12-31T00:00:00+08:00</Date>
</Expiration>
<Status>Enabled</Status>
</Rule>
<Rule>
<ID>id2</ID>
<Filter>
<Prefix>logs/</Prefix>
</Filter>
<Status>Enabled</Status>
<Expiration>
<Days>365</Days>
</Expiration>
</Rule>
</LifecycleConfiguration>