所有文档

          对象存储 BOS

          InitBucketObjectLock

          接口描述

          为指定Bucket创建基于时间的合规保留策略,此时策略状态变成IN_PROGRESS状态。

          注意:

          • 该状态的有效期为24小时,在有效期24小时内,此策略对应的Bucket资源处于保护状态,其保护规则如下所示: 假设您在2013年6月1日创建一个名为examplebucket的Bucket,并且在不同时间上传了file1.txt、file2.txt、file3.txt三个Object。随后在2014年7月1日创建了保护周期为5年的bucket锁策略。有关这三个Object的具体上传时间以及对应的Object到期时间如下:

            Object名称 上传时间 Object到期时间
            file1.txt 2013年6月1日 2018年5月31日
            file2.txt 2014年7月1日 2019年6月30日
            file3.txt 2018年9月30日 2023年9月29日
          • Bucket内的数据处于被保护状态时,任何人包括您尝试删除或修改这些数据,BOS API将返回409 FileImmutable的错误信息,请您谨慎配置该合规策略。

          请求

          • 请求语法

            POST /?objectlock HTTP/1.1
            Host: <BucketName>.bj.bcebos.com
            Date: <Date>
            Authorization: <AuthorizationString>
            Content-Type: application/json; charset=utf-8
            Content-Length: <ContentLength>
            
            { 
               "retentionDays" : 30
            }
          • 请求头域

            无特殊请求头域

          • 请求参数

          名称 类型 描述 是否必须
          retentionDays int 保护周期,单位为天

          响应

          • 响应头域

            无特殊参数

          • 响应元素

            无特殊参数

          示例

          • 请求示例

            POST /?objectlock HTTP/1.1
            Host: <BucketName>.bj.bcebos.com
            x-bce-date: 2016-04-06T06:34:40Z
            Authorization: AuthorizationString
            
            { 
                "retentionDays" : 30
            }
          • 响应示例

            HTTP/1.1 200 OK
            x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
            Content-Length: 0
            Date: Wed, 06 Apr 2016 06:34:40 GMT
            Server: BceBos
          上一篇
          数据同步
          下一篇
          GetBucketObjectLock