CDN加速

GetBucketLifecycle

更新时间:2021-06-17 14:15:08

GetBucketLifecycle

返回空间的生命周期配置信息。需要有IAM wos:GetBucketLifecycle的权限。

请求语法

GET /?lifecycle HTTP/1.1
Host: Bucket.Endpoint
Date: date
Authorization: authorization string

URI请求参数

请求头部

仅使用公共请求头部

请求主体

响应语法

HTTP/1.1 200 OK
x-wos-request-id:
Date:
Server: WCS-Web-Server
Content-Length: 358
 
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns=" https://www.wangsu.com/document "
<Rule>
<ID>id</ID>
<Filter>
<Prefix> </Prefix>
</Filter>
<Status>Enabled</Status>
<Expiration>
<Days>365</Days>
</Expiration>
<Transition>
  <Days>30</Days>
  <StorageClass>IA</StorageClass>
</Transition>
</Rule>
</LifecycleConfiguration>

响应头部

仅使用公共响应头部

响应元素

元素名称

元素描述

LifecyckeConfiguration

定义生命周期配置列表。

类型:XML

子节点:Rule

父节点:空

Rule

定义某个生命周期详细配置。

类型:XML

父节点:LifecycleConfiguration

子节点:Filter

ID

定义每个规则唯一的标识。

类型:字符串

父节点:Rule

Filter

定义符合生命周期规则的对象子集。这个过滤目前仅支持基于对象名前缀。如果没有定义(<Filter></Filter>)则这个此生命周期规则应用于空间中的所有对象。

类型:XML

子节点:Prefix

父节点:Rule

Prefix

定义生命周期配置的过滤条件,空间中只有对符合这个前缀的对象,此生命周期配置才会生效。

类型:字符串

父节点:Filter

Status

定义生命周期配置是否生效

类型:字符串(目前仅有Enabled值)

父节点:Rule

Expiration

定义空间中符合Filter的对象的过期规则。

类型:XML

子节点:Days|Date

父节点:Rule

Days

定义Object相对过期天数,比如当值为13的含义是,将相对最后修改时间3天之后的Object删除

类型:正整数

父节点:Expiration

Transition

转换规则

类型:XML

子节点:Days|StorageClass

父节点:Rule

Days

转换的天数

类型:正整数

父节点:Transition

StorageClass

转换类型,IA-低频,Archive-归档

类型:字符串

父节点:Transition

示例

GET /?lifecycle HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
x-wos-date: Thu, 15 Nov 2016 00:17:21 GMT
Authorization: signatureValue

HTTP/1.1 200 OK
x-wos-request-id: 51991C342C575321
Date: Thu, 15 Nov 2016 00:17:23 GMT
Server: WCS-Web-Serve
Content-Length: 358
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns=" https://www.wangsu.com/document ">
<Rule>
<ID>Archive and then delete rule</ID>
<Filter>
    <Prefix>projectdocs/</Prefix>
</Filter>
<Status>Enabled</Status>
<Expiration>
    <Days>365</Days>
</Expiration>
<Transition>
  <Days>30</Days>
  <StorageClass>IA</StorageClass>
</Transition>
</Rule>
</LifecycleConfiguration>