Get Bucket Lifecycle

最近更新时间:2019-01-14 10:10:57

# GET Bucket lifecycle

描述

此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>

金山云,开启您的云计算之旅

立即注册