最近更新时间：2025-04-02 11:01:36
使用该接口将返回Bucket的生命周期配置,。 使用此接口，您需要是Bucket的所有者或者具有ks3:GetBucketLifecycle权限。
GET /?lifecycle HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}注意：
本接口不使用请求参数。
该接口仅使用常用请求头部。
该接口不使用请求内容。
该接口除了返回常用响应头外，还返回以下响应头。
名称 | 描述 |
|---|---|
x-kss-allow-same-action-overlap | 指定生命周期规则是否允许前缀重叠。
 规则冲突生效说明详见文档：生命周期管理。 |
返回XML中的参数如下所示：
名称 | 描述 |
|---|---|
LifecycleConfiguration | 包含一堆Rule的容器, 一个Bucket最多1000条Rule。
|
Rule | 包含一条规则的容器。
|
ID | Rule的唯一标识, 一个Bucket内ID不能重复。ID长度<=255字符，注意是UTF-8编码字符，不是字节。
|
Filter | 规定前缀，一个Rule只能有一个Filter, 不同Rule的Prefix不能冲突。
|
And | 对象筛选器中的一个子集，指定Tag时需要此元素。包括同时指定Prefix和Tag筛选，以及指定一个或多个Tag筛选。
|
Prefix | 符合这个前缀的Object才会被删。一个Rule只能有一个Filter和一个Prefix。
|
Tag | 标签集合，最多支持10个标签。
|
Key | 标签的 Key，长度不超过128字节，支持英文字母、数字、空格、加号、减号、下划线、等号、点号、冒号、正斜线、反斜线。
|
Value | 标签的 Value，长度不超过256字节, 支持英文字母、数字、空格、加号、减号、下划线、等号、点号、冒号、正斜线、反斜线。
|
Status | 是否执行Rule。
|
Expiration | 规定对应的Object何时被删。
|
IsAccessTime | 指定是否基于最后访问时间匹配规则。
|
ReturnToStdWhenVisit | 指定Object转为其他存储类型后，再次访问时是否将Object转为源存储类型。只有当IsAccessTime设置为true时才有效。
|
Days | 指定生命周期规则在Object最后修改或访问多少天后开始生效。当请求中IsAccessTime取值为true时，该参数表示生命周期规则基于Object的最后访问时间生效，当请求中不设置IsAccessTime或设置IsAccessTime为false时，该参数表示生命周期规则基于Object最后修改时间生效。该参数与Date互斥。
该规则在成功配置的次日0点将会开始生效，全部操作完成时间与对象的数量规模有关，建议客户在开始扫描的次日观察生效情况。 |
Date | last modify day<这个数的Object被删。必须是ISO 8601格式的北京时间。时分秒必须填0，即必须是0点。
|
Transition | 指定Object在有效生命周期中，何时将对象转储为IA或者Archive存储类型。
|
StorageClass | 指定对象转储到目标存储类型。
|
AbortIncompleteMultipartUpload | 生命周期配置中表示未完成分块上传的过期属性。
|
DaysAfterInitiation | 在分块上传任务初始化时间指定多少天之后必须完成上传，否则删除。
|
GET /?lifecycle HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Wed, 01 Mar 2016 12:00:00 GMT
Authorization: authorization stringHTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 312
Connection: keep-alive
Date: Wed, 16 Aug 2017 12:23:54 GMT
Server: KS3
x-kss-allow-same-action-overlap: true
x-kss-request-id: NTk5NDM5NWFfMjQ4OGY3Xzc3NGRf****
<LifecycleConfiguration>
<Rule>
<ID>id1</ID>
<Filter>
<Prefix>documents/</Prefix>
</Filter>
<Status>Enabled</Status>
<Transition>
<Days>100</Days>
<StorageClass>STANDARD_IA</StorageClass>
</Transition>
</Rule>
<Rule>
<ID>id2</ID>
<Filter>
<Prefix>logs/</Prefix>
</Filter>
<Status>Enabled</Status>
<Expiration>
<Days>10</Days>
</Expiration>
</Rule>
</LifecycleConfiguration>HTTP状态码 | 错误码 | 描述 |
|---|---|---|
404 Not Found | NoSuchLifecycleConfiguration | Bucket没有配置生命周期规则。 |
纯净模式
