接口描述

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

请求（Request）

• 请求语法

  GET /?lifecycle HTTP/1.1
  Host: <BucketName>.bj.bcebos.com
  Date: date
  Authorization: AuthorizationString

• 请求头域

  无特殊参数

• 请求参数

  无特殊参数

响应（Response）

• 请求参数

  规则项	描述	是否必填	备注
  rule	规则的列表	必填	所有规则的列表
  +id	规则的标识符。	必填	同一个bucket内规则id必须唯一，不能重复。如果用户不填系统会自动帮用户生成一个。
  +status	规则的状态。	必填	取值为enabled或disabled，当规则处于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	执行的操作名称。	必填	取值为Transition、DeleteObject、AbortMultipartUpload。
  +storageClass	Object的存储类型	可选	action为Transition时可以设定，取值为STANDARD_IA或COLD或ARCHIVE，表示从原存储类型转为低频存储或冷存储或归档存储。

• 响应元素

  无特殊元素

• 响应头域

  无特殊头域

注意事项

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

基础生命周期请求示例

• 请求示例

   GET /?lifecycle HTTP/1.1
   Host: <BucketName>.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"
                   }
               }
           ]
       }  

智能分层请求示例

• 请求语法

   GET /?lifecycle HTTP/1.1
   Host: <BucketName>.bj.bcebos.com
   Date: Tue, 26 Jul 2022 05:01:28 GMT
   Authorization: AuthorizationString

• 响应示例

  HTTP/1.1 200 OK
  Date: Tue, 26 Jul 2022 09:41:29 GMT
  Server: BceBos
  x-bce-request-id: ac07037d-f40e-45e0-b126-e38adc238cad
  Connection: keep-alive
  Content-Length: 740
  
  {
     "rule": [
         {
             "id": "sample-rule-intelligent-tiering-prefix",
             "status": "enabled",
             "resource": [
                 "bucket/*"
             ],
             "action": {
                 "name": "IntelligentTiering"
             }
         },
         {
             "id": "sample-rule-delete-prefix",
             "status": "enabled",
             "resource": [
                 "bucket/*"
             ],
             "condition": {
                 "time": {
                     "dateGreaterThan": "$(lastModified)+P365D"
                 }
             },
             "action": {
                 "name": "DeleteObject"
             }
         },
         {
             "id": "sample-rule-abort-multiupload-prefix",
             "status": "enabled",
             "resource": [
                 "bucket/*"
             ],
             "condition": {
                 "time": {
                     "dateGreaterThan": "$(lastModified)+P7D"
                 }
             },
             "action": {
                 "name": "AbortMultipartUpload"
             }
         }
     ]
  }