此接口用于返回配置的Bucket生命周期。

请求语法

GET /?lifecycle HTTP/1.1
Host: BucketName.oos-cn.ctyunapi.cn
Date: date
Authorization: SignatureValue

请求参数

响应结果

名称
描述
LifecycleConfiguration
生命周期规则容器。
类型：容器。
子节点：Rule。
Rule
生命周期规则的容器。
类型：容器。
父节点：LifecycleConfiguration。
ID
规则的唯一标识。
类型：字符串。
父节点：Rule。
Prefix
使用规则的文件前缀。
类型：字符串。
父节点：Rule。
Status
生命周期规则的状态：
Enabled：生命周期规则生效。
Disabled：生命周期规则不生效。
类型：字符串。
父节点：Rule。
Expiration
描述过期动作的容器。
类型：容器。
父节点：Rule。
子节点：Days或Date。
Transition
生命周期规则的转换存储类型。
类型：容器。
父节点：Rule。
子节点：StorageClass、Days或Date。
StorageClass
文件转换的存储类型：STANDARD_IA：低频访问存储。
类型：字符串。
父节点：Transition。
Days
当IsAccessTime为false时，表示生命周期规则在匹配文件最后一次修改多少天后生效。
当IsAccessTime为true时，表示生命周期规则在匹配文件最后一次访问时间多少天后生效。
类型：整型。
父节点：Expiration或Transition。
IsAccessTime
是否基于最后一次访问时间匹配规则：
true：生命周期规则匹配文件的最后一次访问时间。
false：生命周期规则匹配文件的最后一次修改时间。
类型：布尔型。
父节点：Transition。
Date
生命周期规则生效日期，OOS对在此日期之前创建的文件执行生命周期规则。
类型：字符串。
父节点：Expiration或Transition。
AtimeBase
当生命周期规则基于最后一次访问时间匹配时，返回示例中包含AtimeBase元素，表示默认最后一次访问的时间戳（从1970-01-01 00:00:00 UTC计算起的秒数），即为Bucket开启访问跟踪时间点的时间戳。
类型：时间戳。
父节点：Rule。

请求示例1

下面的例子显示所有以logs为前缀的文件将在最后一次修改时间的30天后到期删除。

GET /?lifecycle HTTP/1.1
Host: example-bucket.oos-cn.ctyunapi.cn
Date: Tue, 13 Dec 2011 17:54:50 GMT
Authorization: SignatureValue

响应示例1

HTTP/1.1 200 OK
x-amz-request-id: b13502b728c8468a2da7a9a0a2a867696f5d5f61636567696b
Date:Tue, 13 Dec 2011 19:14:41 GMT
Content-Length: 267
Server: CTYUN

<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Rule>
	<ID>30-day-log-deletion-rule</ID>
	<Prefix>logs</Prefix>
	<Status>Enabled</Status>
	<Expiration>
		<Days>30</Days>
	</Expiration>
</Rule>
</LifecycleConfiguration>

请求示例2

下面的例子显示所有以test为前缀的文件将在最后一次访问时间的3天后转为低频访问存储。

GET /?lifecycle HTTP/1.1
x-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date: 20230821T092414Z
Host: example-bucket.oos-cn.ctyunapi.cn
Connection: keep-alive
Authorization: SignatureValue

响应示例2

HTTP/1.1 200 OK
x-amz-request-id: 92bc7f34cf824ffb057f81787a803f41493537393b3d3f4143
Date:Tue, 13 Dec 2011 19:14:41 GMT
Content-Length: 267
Server: CTYUN

<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Rule>
        <ID>test_lifecycle_1</ID>
        <Prefix>test</Prefix>
        <Status>Enabled</Status>
        <Transition>
            <Days>3</Days>
            <IsAccessTime>true</IsAccessTime>
            <StorageClass>STANDARD_IA</StorageClass>
        </Transition>
        <AtimeBase>1692608940364</AtimeBase>
    </Rule>
</LifecycleConfiguration>