186
云计算
负载均衡
产品简介
产品价格
快速入门
用户指南
实践操作
常见问题
购买指南
云服务器
产品简介
计费规则
购买指导
控制台使用指南
常见问题
云数据库
产品简介
计费规则
购买指导
快速入门
连接实例
控制台使用指南
对象存储
产品简介
控制台使用指南
程序员百科
Python
天翼云对象存储(经典版)I型API参考-PUT Bucket object lock

产品推荐:

1、安全稳定的云服务器租用,2核/2G/5M仅37元,点击抢购>>>

2、高防物理服务器20核/16G/50M/500G防御仅350元,点击抢购>>>

3、百度智能建站(五合一网站)仅880元/年,点击抢购>>> 模板建站(PC+手机站)仅480元/年,点击抢购>>>

4、阿里云服务器2核2G3M仅99元/年、2核4G5M仅199元/年,新老同享,点击抢购>>> 

5、腾讯云服务器2核2G4M仅99元/年、新老同享,点击抢购>>>   



点击这里注册天翼云特邀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: 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>


请求头

名称

描述

是否必须

Content-MD5

数据的base64编码的128位MD5。此请求头必填,以便校验数据的完整性。

请求参数

名称

描述

是否必须

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


这条帮助是否解决了您的问题? 已解决 未解决

提交成功!非常感谢您的反馈,我们会继续努力做到更好! 很抱歉未能解决您的疑问。我们已收到您的反馈意见,同时会及时作出反馈处理!