文档首页/ 对象存储服务 OBS/ API参考/ API/ 桶的高级配置/ 配置桶级默认WORM策略
更新时间：2025-08-29 GMT+08:00
分享

配置桶级默认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/">
    <ObjectLockEnabled>Enabled</ObjectLockEnabled>
    <Rule>
       <DefaultRetention>
          <Days>integer</Days>
          <Mode>COMPLIANCE</Mode>
          <Years>integer</Years>
       </DefaultRetention>
    </Rule>
</ObjectLockConfiguration>

请求消息参数

该请求消息中不使用消息参数

请求消息头

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

请求消息元素

表1 请求消息元素表

参数名称

是否必选

参数类型

描述

ObjectLockConfiguration

是

Container

参数解释：

桶级WORM配置的容器，ObjectLockConfiguration是ObjectLockEnabled和Rule的父节点。

约束限制：

不涉及

取值范围：

请详见表2。

默认取值：

不涉及
表2 ObjectLockConfiguration参数解释

参数名称

是否必选

参数类型

描述

ObjectLockEnabled

否

String

参数解释：

桶级WORM开关状态。

约束限制：

不涉及

取值范围：

Enabled：启用桶级WORM功能。

默认取值：

不涉及

Rule

ObjectLockEnabled为Enabled时必选，不携带则会清空当前配置的桶级默认WORM策略

Container

参数解释：

桶级WORM策略的规则容器，Rule是DefaultRetention的父节点。

约束限制：

不涉及

取值范围：

请详见表3。

默认取值：

不涉及
表3 Rule参数说明

参数名称

是否必选

参数类型

描述

DefaultRetention

如果有Rule容器则必选

Container

参数解释：

桶级WORM策略的容器，DefaultRetention是Mode、Days、Years的父节点。

约束限制：

不涉及

取值范围：

请详见表4。

默认取值：

不涉及
表4 DefaultRetention参数解释

参数名称

是否必选

参数类型

描述

Mode

如果有DefaultRetention容器则必选

String

参数解释：

桶的WORM保护策略。

约束限制：

不涉及

取值范围：

COMPLIANCE：合规模式。

默认取值：

不涉及

Days

如果有DefaultRetention容器则和Years二选一，必须选择其中一个且不能同时指定

Integer

参数解释：

保护天数。单位：天。

约束限制：

Days和Years只能有一个不为0，并且在规定取值范围内。

取值范围：

1~36500

默认取值：

不涉及

Years

如果有DefaultRetention容器则和Days二选一，必须选择其中一个且不能同时指定

Integer

参数解释：

默认的保护年数，单位：年。

约束限制：

  • 一年实际上视为保护365天，不考虑闰年。
  • Days和Years只能有一个不为0，并且在规定取值范围内。

取值范围：

1~100

默认取值：

不涉及

响应消息样式

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

响应消息头

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

响应消息元素

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

错误响应消息

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

表5 错误响应消息

错误码

描述

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
<ObjectLockConfiguration xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/">
    <ObjectLockEnabled>Enabled</ObjectLockEnabled>
    <Rule>
       <DefaultRetention>
          <Mode>COMPLIANCE</Mode>
          <Years>2</Years>
       </DefaultRetention>
    </Rule>
</ObjectLockConfiguration>

响应示例 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
<ObjectLockConfiguration xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/">
</ObjectLockConfiguration>

响应示例 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
父主题： 桶的高级配置

相关文档