接口描述

为指定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
  }

• 请求头域

  无特殊请求头域

• 请求参数

响应

• 响应头域

  无特殊参数

• 响应元素

  无特殊参数

示例

• 请求示例

  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