喜讯：国内、香港、海外云服务器租用特惠活动，2核/4G/10M仅需31元每月，点击抢购>>>

点击这里注册天翼云特邀VIP帐号，立即体验天翼云对象存储>>>

天翼云对象存储（经典版）I型API参考-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: 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