对象存储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