对象存储BOS

    PutBucketLifecycle

    接口描述

    本接口用来创建生命周期管理规则。

    说明: 只有bucket的owner且拥有FULL_CONTROL权限才能够进行此请求。

    请求(Request)

    • 请求语法

      PUT /?lifecycle HTTP/1.1
      Host: <BucketName>.bj.bcebos.com
      x-bce-date: date
      Content-Length: request-body length
      Content-Type: application/json; charset=utf-8
      Authorization: AuthorizationString
      
      {
          "rule": [
              {
                  "id": "rule-id", 
                  "status": "enabled", 
                  "resource": [
                      "bucket/prefix/*"
                  ], 
                  "condition": {
                      "time": {
                          "dateGreaterThan": "2016-09-07T00:00:00Z"
                      }
                  }, 
                  "action": {
                      "name": "DeleteObject"
                  }
              },
      }
    • 请求头域

      无特殊参数

    • 请求参数

      规则项 描述 是否必填 备注
      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,表示从原存储类型转为低频存储或冷存储或归档存储。

    响应(Response)

    • 响应元素

      无特殊元素

    • 响应头域

      无特殊头域

    示例

    • 请求示例

      PUT /?lifecycle HTTP/1.1
      Host: bucket.bj.bcebos.com
      x-bce-date: 2016-08-16T08:23:49Z
      Content-Length :1324
      Content-Type: application/json; charset=utf-8
      Authorization: AuthorizationString
      
      {
          "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"
                  }
              }
          ]
      }
    • 响应示例

       HTTP/1.1 200 OK
       x-bce-request-id: 0A49CE4060975EAC
       Date: Wed, 12 Oct 2016 17:50:00 GMT
       Content-Length: 0
       Connection: keep-alive
       Server: BceBos
    上一篇
    权限控制
    下一篇
    GetBucketLifecycle