Get Bucket Lifecycle

描述

此GET操作返回bucket的lifecyle配置, 即描述各条Rule的一个xml。 使用此接口，您需要是bucket的所有者或者具有获取生命周期管理规则的权限，即ks3:GetBucketLifecycle。

请求

语法

GET /?lifecycle HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}

注意：

• endpoint与Region对应关系
• SignatureValue签名算法

请求参数

本接口不使用请求参数。

请求头部

只使用常用请求头部。获取更多信息，请点击常用请求头部。

请求内容

不使用请求内容。
KS3在策略中指定的一组权限。每一个权限，都会映射到特定 KS3 操作。

响应

响应头部

只带有常用响应头部。获取更多信息，请点击常用响应头部。

响应内容

返回一个xml，可能有下列节点：

名称	描述	是否返回
LifecycleConfiguration	包含一堆Rule的容器, 一个Bucket最多1000条Rule。 类型：Container 子节点: Rule 父节点：无	是
Rule	包含一条规则 类型: Container 父节点：LifecycleConfiguration	是
ID	Rule的唯一标识, 一个Bucket内ID不能重复。ID长度<=255字符，注意是utf8编码字符，不是字节。 类型：String 父节点：Rule	是
Filter	规定前缀，一个Rule只能有一个Filter, 不同rule的prefix不能冲突。 类型：Container 子节点：Prefix 父节点：Rule	否
And	对象筛选器中的一个子集，仅当需要指定多种筛选规则时才需要此元素。 例如：同时指定 Prefix 和 Tag 筛选，或同时指定多个 Tag 筛选。 类型：Container 父节点：LifecycleConfiguration.Rule.Filter	否
Prefix	符合这个前缀的object才会被删。一个Rule只能有一个Filter和一个Prefix。 类型：String 父节点：Filter	否
Tag	标签集合，最多支持10个标签 类型：Container	否
Key	标签的 Key，长度不超过128字节，支持英文字母、数字、空格、加号、减号、下划线、等号、点号、冒号、正斜线、反斜线。 类型：String	否
Value	标签的 Value，长度不超过256字节, 支持英文字母、数字、空格、加号、减号、下划线、等号、点号、冒号、正斜线、反斜线。 类型：String	否
Status	Enabled状态，该Rule就定期被执行；Disabled，该Rule被忽略，但该Rule随时能被Enable而不是被删。 类型：String 父节点：Rule 取值: Enabled, Disabled	是
Expiration	规定对应的object何时被删。 类型：Container 子节点：Days，Date 父节点：Rule	否
Days	规定一个正数，对应object在last modify多少天之后被删。 类型: 整数 父节点: Expiration，Transition	是，如果没有Days
Date	last modify day<这个数的object被删。必须是ISO 8601格式的北京时间。时分秒必须填0，即必须是0点。 类型：String 父节点: Expiration，Transition	是，如果没有Date
Transition	指定Object在有效生命周期中，何时将对象转储为IA或者Archive存储类型。 类型：Container 子节点: Days，Date，StorageClassg	否
StorageClass	指定对象转储到目标存储类型。 父节点：Transition 取值：STANDARD_IA,ARCHIVE（控制台使用aws sdk，不支持ARCHIVE）	否，如果Transition有的话，则必须包含。

示例

请求示例

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
Content-Type: application/xml
Content-Length: 312
Date: Wed, 16 Aug 2017 12:23:54 GMT
Server: tencent-cos
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>