更新时间:2024-10-21 gmt 08:00

配置桶级默认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

请求消息元素

表1 请求消息元素表

名字

描述

是否必选

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描述。

表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: 157

    enabled
    
       
          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

相关文档

网站地图