配置对象级worm保护策略-九游平台

功能介绍

开启了worm开关的桶，上传的对象支持配置或修改对象保护期限。

• 如果上传对象时没有配置保护期限或自动应用桶级默认保护策略，您可以通过该操作配置对象保护期限。
• 如果上传对象时配置了保护期限或自动应用了默认保护期限，允许用户通过该操作延长保护期限。
• 对象保护期限仅允许修改，不允许删除。

  用户需要拥有“putobjectretention”权限才能配置或修改对象保护期限。

多版本

开启了worm开关的桶默认开启了多版本，因此桶内对象在上传时会具备版本号。您在配置对象级worm保护策略时可以指定版本号来为特定版本的对象配置，如果您不指定版本号，则改动只会对同名对象的最新版本生效。worm功能不会对带唯一版本号的删除标记生效。

多段操作

多段上传的对象在合并前不会自动应用桶级默认worm策略，也无法通过在上传或合并时指定头域来配置对象级worm保护策略，指定已上传的段作为此接口的目标对象也无法进行配置。如果您需要对多段对象进行保护，您可以在合并多段对象后通过此接口为其配置对象级worm保护策略。

请求消息样式

put /objectname?retention http/1.1 
host: bucketname.obs.cn-north-4.myhuaweicloud.com 
date: date
authorization: authorization

    string
    timestamp

请求消息参数

请求参数说明如表1所示。

请求消息头

该请求使用公共请求消息头，具体参见表3。

请求消息元素

响应消息样式

http/1.1 status_code
date: date
content-length: length

响应消息头

该请求的响应消息使用公共消息头，具体请参考表1。

响应消息元素

该请求的响应消息不带消息元素。

错误响应消息

此请求可能的特殊错误如下表2描述。

其余错误已经包含在表2中。

请求示例

put /objectname?retention 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

    compliance
    1435728035000

响应示例

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