Get Bucket Lifecycle

最近更新时间:2021-04-07 20:17:33

查看PDF

描述

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

请求

语法

GET /?lifecycle HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {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>

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

  • 内容不全,不深入
  • 内容更新不及时
  • 描述不清晰,比较混乱
  • 系统或功能太复杂,缺乏足够的引导
  • 内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈