对象存储(KS3)

      文档中心 对象存储(KS3) Bucket相关 生命周期（Lifecycle） GET Bucket Lifecycle

      GET Bucket Lifecycle

      最近更新时间：2023-02-03 14:04:17

      描述

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

      请求

      语法

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

      注意：

      请求参数

      本接口不使用请求参数。

      请求头部

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

      请求内容

      该接口不使用请求内容。

      响应

      响应头部

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

      响应内容

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

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

      示例

      请求示例

      GET /?lifecycle HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.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
Connection: keep-alive
Date: Wed, 16 Aug 2017 12:23:54 GMT
Server: KS3
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>

      错误码

      错误码 HTTP状态码 描述
      NoSuchLifecycleConfiguration 404 Not Found Bucket没有配置生命周期规则。

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

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

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

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

      更多建议

      0/200

      评价建议不能为空

      提交成功！

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

      问题反馈