使用此操作可以开启合规保留功能，开启后将对Bucket中所有文件生效。只有根用户和有权限的子用户才可以进行此操作，匿名用户不能进行此操作。
开启Bucket合规保留功能后，任何用户（包括根用户）都不能对此Bucket内处于合规保留期的文件进行修改和删除。
可以重复调用此接口：
- 如果已经开启合规保留策略：设置合规保留时长大于或等于上次设置的时长，才能生效。如果使用Years和Days两种方式设置合规保留时长，年与天的换算关系为：1年等于365天。
- 如果未开启合规保留策略：设置合规保留时长可以大于、等于或小于上次设置的时长。
合规保留一旦开启，不能关闭，不能缩短合规保留时长，但可以延长合规保留时长。
合规保留的时间精确到秒，例如对Bucket A设置合规保留时长为10天，文件A属于Bucket A，A1的最后更新时间为2019-3-1 12:00:00，该文件会在2019-3-11 12:00:01过合规保留期。
任何用户（包括根用户）都不能修改、覆盖、删除处于合规保留期的文件。
处于合规保留期的文件，无法通过调用API、控制台修改文件的存储类型，只能通过生命周期修改存储类型。
处于合规保留期的文件，如果设置了生命周期规则，则修改存储类型的生命周期规则可以生效，设置删除操作的生命周期规则待文件过了合规保留期后才能生效。
请求语法
PUT /?object-lock HTTP/1.1
Host: BucketName.oos-cn.ctyunapi.cn
Date: date
Content-MD5:md5
Content-Length:length
Authorization: SignatureValue
<ObjectLockConfiguration>
<ObjectLockEnabled>Enabled</ObjectLockEnabled>
<Rule>
<DefaultRetention>
<Mode>COMPLIANCE</Mode>
<Days>days</Days>
<Years>years</Years>
</DefaultRetention>
</Rule>
</ObjectLockConfiguration>
请求头
| 名称 | 描述 | 是否必须 |
|---|---|---|
| Content-MD5 | 数据的base64编码的128位MD5。此请求头必填，以便校验数据的完整性。 | 是 |
| 名称 | 描述 | 是否必须 |
|---|
请求参数
| 名称 | 描述 | 是否必须 |
|---|---|---|
| BucketName | 存储桶名称。 | 是 |
| ObjectLockConfiguration | 合规保留配置信息的容器。 类型：容器。 子节点：ObjectLockEnabled。 | 是 |
| ObjectLockEnabled | Bucket是否开启合规保留功能。 类型：枚举 取值：
父节点：ObjectLockConfiguration。 | 是 |
| Rule | 设置合规保留规则。 类型：容器。 父节点：ObjectLockConfiguration。 子节点：DefaultRetention。 | 否 |
| DefaultRetention | 默认的合规保留配置。 类型：容器。 父节点：Rule。 子节点：Mode、Days或Years二选一。 | 是 |
| Mode | 合规保留模式。 类型：枚举。 取值：COMPLIANCE：合规保留。 父节点：DefaultRetention。 | 是 |
| Days | 合规保留的天数。 类型：整型。 取值：整数形式，1~36500。 说明 年与天的换算关系：1年等于365天。 父节点：DefaultRetention。 | 条件 Days和Years必须二选一。 |
| Years | 合规保留的年数。 类型：整型。 取值：整数形式，1~100。 说明 年与天的换算关系：1年等于365天。 父节点：DefaultRetention。 | 条件 Days和Years必须二选一。 |
| 名称 | 描述 | 是否必须 |
|---|
请求示例
PUT /?object-lock HTTP/1.1
Host: example-bucket.oos-cn.ctyunapi.cn
Date: Tue, 12 May 2020 06:18:52 GMT
Content-Type: application/xml; charset=utf-8
Content-Length: 232
Content-MD5: m08Xh8w1oh6bZrLA6Hseaw==
Authorization: SignatureValue
<ObjectLockConfiguration>
<ObjectLockEnabled>Enabled</ObjectLockEnabled>
<Rule>
<DefaultRetention>
<Mode>COMPLIANCE</Mode>
<Days>1</Days>
</DefaultRetention>
</Rule>
</ObjectLockConfiguration>
响应示例
HTTP/1.1 200 OK
x-amz-request-id: a7ed9cfd3fc743c035afb1a8aab06f71776567696b6d6f7173
Date: Tue, 12 May 2020 03:24:38 GMT
Server: CTYUN
