PutBucketLifecycle
所有文档

          对象存储 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"
                        }
                    },
            }
          • 请求头域

            无特殊参数

          • 请求参数

            规则项 描述 是否必填 备注
            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时可以设定,非多AZ bucket的取值为STANDARD_IACOLDARCHIVE,表示从原存储类型转为低频存储或冷存储或归档存储;对于多AZ的bucket,取值只能为STANDARD_IA,表示从原存储类型转为低频存储

          响应(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