GetBucketLifecycle
所有文档

          对象存储 BOS

          GetBucketLifecycle

          接口描述

          此接口用于获取定义的生命周期管理规则详细信息。

          请求(Request)

          • 请求语法

            GET /?lifecycle HTTP/1.1
            Host: <BucketName>.bj.bcebos.com
            Date: date
            Authorization: AuthorizationString
          • 请求头域

            无特殊参数

          • 请求参数

            无特殊参数

          响应(Response)

          • 请求参数

            规则项 描述 是否必填 备注
            rule 规则的列表 必填 所有规则的列表
            +id 规则的标识符。 必填 同一个bucket内规则id必须唯一,不能重复。如果用户不填系统会自动帮用户生成一个。
            +status 规则的状态。 必填 取值为enableddisabled,当规则处于disabled时规则不生效。
            +resource 规则对哪些资源生效。 必填 举例:对samplebucket里以prefix/为前缀的Object生效:samplebucket/prefix/*;对samplebucket里所有Object生效:samplebucket/*
            +condition 规则依赖的条件。 必填 目前只支持time形式。
            +time 时间限制条件。 必填 通过定义的dateGreaterThan实现。
            ++dateGreaterThan 描述时间关系。 必填 支持绝对时间date和相对时间days。绝对时间date格式为yyyy-mm-ddThh:mm:ssZ,eg. 2016-09-07T00:00:00Z。绝对时间为UTC时间, 必须以00:00:00(UTC 0点)结尾;相对时间days的描述遵循ISO8601, 支持的最小时间粒度为天,如: $(lastModified)+P7D表示的时间为object的last-modified之后7天。
            action 对resource执行的操作动作。 必填 -
            +name 执行的操作名称。 必填 取值为TransitionDeleteObjectAbortMultipartUpload
            +storageClass Object的存储类型 可选 action为Transition时可以设定,取值为STANDARD_IACOLDARCHIVE,表示从原存储类型转为低频存储或冷存储或归档存储。
          • 响应元素

            无特殊元素

          • 响应头域

            无特殊头域

          注意事项

          • 如果请求的源Bucket不存在,返回404错误,错误码为NoSuchBucket。
          • 如果请求的源Bucket没有配置lifecycle,返回404错误,错误码为NoLifecycleConfiguration。

          示例

          • 请求示例

             GET /?lifecycle HTTP/1.1
             Host: bucket.bj.bcebos.com
             Date: Thu, 15 Sep 2016 00:16:26 GMT
             Authorization: AuthorizationString
          • 响应示例

                 HTTP/1.1 200 OK
                 Date: Thu, 15 Sep 2016 00:17:23 GMT
                 Server: BceBos
                 x-bce-request-id: 1a5fd81e-626b-45b3-a885-15fff9cd106c
                 Connection: keep-alive
                 Content-Length: 358
            
                 {
                     "rule": [
                         {
                             "id": "sample-rule-delete-prefix", 
                             "status": "enabled", 
                             "resource": [
                                 "bucket/prefix/*"
                             ], 
                             "condition": {
                                 "time": {
                                     "dateGreaterThan": "2016-09-07T00:00:00Z"
                                 }
                             }, 
                             "action": {
                                 "name": "DeleteObject"
                             }
                         },
                         {
                             "id": "sample-rule-transition-prefix", 
                             "status": "enabled", 
                             "resource": [
                                 "bucket/prefix/*"
                             ], 
                             "condition": {
                                 "time": {
                                     "dateGreaterThan": "$(lastModified)+P7D"
                                 }
                             }, 
                             "action": {
                                 "name": "Transition"
                                 "storageClass": "STANDARD_IA"
                             }
                         },
                         {
                             "id": "sample-rule-abort-multiupload-prefix", 
                             "status": "enabled", 
                             "resource": [
                                 "bucket/prefix/*"
                             ], 
                             "condition": {
                                 "time": {
                                     "dateGreaterThan": "$(lastModified)+P7D"
                                 }
                             }, 
                             "action": {
                                 "name": "AbortMultipartUpload"
                             }
                         }
                     ]
                 }  
          上一篇
          PutBucketLifecycle
          下一篇
          DeleteBucketLifecycle