华为云对象存储OBS配置对象级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所示。

表1 请求消息参数

参数名称

描述

是否必选

versionId

对象的版本号。标示更改指定版本的对象的对象级WORM策略。不携带则为最新版本。

类型:String

请求消息头

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

请求消息元素

名字

描述

是否必选

Retention

对象级WORM保护策略配置的容器

类型:Container

Mode

对象的保护策略,当前仅支持合规模式”COMPLIANCE”

类型:String

示例:COMPLIANCE

RetainUntilDate

对象的保护期限,时间戳格式,精确到毫秒级,如2015年7月1日13点20分35秒对应的值为1435728035000。

说明:

该字段必须晚于当前时间,且仅可延长不能缩短。

类型:Long

示例:1435728035000

响应消息样式

HTTP/1.1 status_code
Date: date
Content-Length: length

响应消息头

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

响应消息元素

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

错误响应消息

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

表2

错误码

描述

HTTP状态码

InvalidRequest

目标桶没有开启桶级WORM开关

400

InvalidRequest

保护期限设置错误

400

MalformedObjectLockError

策略配置格式错误

400

其余错误已经包含在表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

父主题: 对象操作

同意关联代理商云淘科技,购买华为云产品更优惠(QQ 78315851)

内容没看懂? 不太想学习?想快速解决? 有偿解决: 联系专家