初始化合规保留策略
更新时间：2021-12-29
接口说明
本接口为指定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的错误信息，请您谨慎配置该合规策略。
请求URI
POST /v1/{bucketName}/?objectlock
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 | 参数位置 |
|---|---|---|---|---|---|
| bucketName | String | 是 | bucket的名称 | "bucketName_example" | Path |
请求体参数
请求体字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| retentionDays | Integer | 是 | 保护周期，单位为天 | 30 |
响应体参数
无
请求示例
POST /v1/bucketName_example/?objectlock
<公共请求头>
{
"retentionDays" : 30
}响应示例
无
错误码
请参考通用错误码