此接口用于返回配置的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="//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="//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>