文档简介：
PUT Bucket object lock
使用此操作可以开启合规保留功能，开启后将对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: bucket-name.oos-cn.ctyunapi.cn Date: date Authorization: authorization-string Content-MD5:md5 Content-Length:length
<ObjectLockConfiguration> <ObjectLockEnabled>Enabled</ObjectLockEnabled> <Rule> <DefaultRetention> <Mode>COMPLIANCE</Mode> <Days>days</Days> <Years>years</Years> </DefaultRetention> </Rule> </ObjectLockConfiguration> |
请求头
|
名称 |
描述 |
是否必须 |
|
ObjectLockConfiguration |
合规保留配置信息的容器。 类型：容器 子节点：ObjectLockEnabled |
是 |
|
ObjectLockEnabled |
Bucket是否开启合规保留功能。 类型：枚举 父节点：ObjectLockConfiguration 有效值： l Enabled：开启合规保留； l Disabled：不开启合规保留。 |
是 |
|
Rule |
设置合规保留规则。 类型：容器 父节点：ObjectLockConfiguration 子节点：DefaultRetention |
否 |
|
DefaultRetention |
默认的合规保留配置。 类型：容器 父节点：Rule 子节点：Mode、Days或Years二选一 |
是 |
|
Mode |
合规保留模式。 类型：枚举 父节点：DefaultRetention 有效值：COMPLIANCE：合规保留。 |
是 |
|
Days |
合规保留的天数。 类型：整型 父节点：DefaultRetention 取值：整数形式，1~36500。 说明：年与天的换算关系：1年等于365天。 |
条件 Days和Years必须二选一 |
|
Years |
合规保留的年数。 类型：整型 父节点：DefaultRetention 取值：整数形式，1~100。 说明：年与天的换算关系：1年等于365天。 |
条件 Days和Years必须二选一 |
请求示例
|
PUT /?object-lock HTTP/1.1 Host: test.oos-cn.ctyunapi.cn Authorization:authorization Date: Tue, 12 May 2020 06:18:52 GMT Content-Type: application/xml; charset=utf-8 Content-Length: 232 Content-MD5: m08Xh8w1oh6bZrLA6Hseaw==
<ObjectLockConfiguration> <ObjectLockEnabled>Enabled</ObjectLockEnabled> <Rule> <DefaultRetention> <Mode>COMPLIANCE</Mode> <Days>1</Days> </DefaultRetention> </Rule> </ObjectLockConfiguration> |
响应示例
|
HTTP/1.1 200 OK x-amz-request-id: 0431A9A8190CF829 Date: Tue, 12 May 2020 03:24:38 GMT Server: CTYUN |
