配置桶级默认worm策略-九游平台
功能介绍
桶的worm开关开启后,支持配置默认保护策略和保护期限。
当您在桶内配置了桶级默认worm策略以后,如果您在上传对象时没有指定保护策略和保护期限,则新上传的对象会自动应用桶级默认worm策略。和配置对象级worm保护策略不同的地方在于,对象级worm保护策略需要您提供一个明确的时间,在这个时间之前对象都会受到保护,桶级默认worm策略则要求您提供一个保护期限,实际上对象受到保护的时间点为其上传时间 您指定的保护期限。
要正确执行此操作,需要确保执行者有 "putbucketobjectlockconfiguration"权限。默认情况下只有桶的所有者可以执行此操作,也可以通过设置桶策略或用户策略授权给其他用户。
- 您可以修改甚至清空桶级默认worm策略,但这仅对修改后上传的对象生效,修改前上传的对象的保护状态不受影响。
- 多段上传的对象在合并前不受保护,合并后受桶级默认对象策略保护,您可以在其合并后单独为其配置对象级worm保护策略。
其它约束如下:
- 策略目前仅支持设置为合规模式"compliance"
- 支持设置的保留期限为1天-100*365天或1年~100年。
请求消息样式
put /?object-lock http/1.1 host: bucketname.obs.cn-north-4.myhuaweicloud.com date: date authorization: authorization content-type: application/xml content-length: length <objectlockconfiguration xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/">enabled integer compliance integer
请求消息参数
该请求消息中不使用消息参数
请求消息头
该请求使用公共消息头,具体参见表3。
请求消息元素
名字 |
描述 |
是否必选 |
---|---|---|
objectlockconfiguration |
桶级worm配置的容器 类型:container |
是 |
objectlockenabled |
桶级worm开关状态,只能为enabled 类型:string 示例:enabled |
否 |
rule |
桶级默认worm策略的规则容器 类型:container |
设置桶级默认worm策略配置时必选,不携带则会清空当前配置的桶级默认worm策略 |
defaultretention |
桶级默认worm策略的容器 类型:container |
如果有rule容器则必选 |
mode |
默认的保护策略,当前仅支持合规模式"compliance" 类型:string 示例:compliance |
如果有defaultretention容器则必选 |
days |
默认的保护天数,取值范围为1-36500天 类型:integer 示例:1 |
如果有defaultretention容器则和years二选一,必须选择其中一个且不能同时指定 |
years |
默认的保护年数,取值范围为1-100年,一年实际上视为保护365天,不会考虑闰年 类型:integer 示例:1 |
如果有defaultretention容器则和days二选一,必须选择其中一个且不能同时指定 |
响应消息样式
http/1.1 status_code date: date content-length: length
响应消息头
该请求的响应消息使用公共消息头,具体请参考表1。
响应消息元素
该请求的响应消息不带消息元素。
错误响应消息
此请求可能的特殊错误如下表2描述。
错误码 |
描述 |
http状态码 |
---|---|---|
invalidrequest |
目标桶没有开启桶级worm开关 |
400 |
malformedxml |
策略配置格式错误 |
400 |
其余错误已经包含在表2中。
请求示例 1
配置桶级默认worm策略为保护两年
put /?object-lock http/1.1 host: bucketname.obs.cn-north-4.myhuaweicloud.com date: wed, 01 jul 2015 02:25:05 gmt authorization: obs h4ipjx0tqththebqqcec:75/y4ng1izvzc1ntgxpmxte6ynw= content-type: application/xml content-length: 157enabled compliance 2
响应示例 1
http/1.1 200 ok server: obs x-obs-request-id: bf260000016435ce298386946ae4c482 x-obs-id-2: 32aaaqaaeaabsaagaaeaabaaaqaaeaabct9w2tcvlmmj plfdopad62s0npbaruz date: wed, 01 jul 2015 02:25:06 gmt content-length: 0
请求示例 2
清空当前的桶级默认worm策略配置
put /?object-lock http/1.1 host: bucketname.obs.cn-north-4.myhuaweicloud.com date: wed, 01 jul 2015 02:25:05 gmt authorization: obs h4ipjx0tqththebqqcec:75/y4ng1izvzc1ntgxpmxte6ynw= content-type: application/xml content-length: 157
响应示例 2
http/1.1 200 ok server: obs x-obs-request-id: bf260000016435ce298386946ae4c482 x-obs-id-2: 32aaaqaaeaabsaagaaeaabaaaqaaeaabct9w2tcvlmmj plfdopad62s0npbaruz date: wed, 01 jul 2015 02:25:06 gmt content-length: 0
相关文档
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨