更新时间：2024-10-21 GMT+08:00
获取桶级默认WORM策略
功能介绍
获取该桶设置的桶级默认WORM策略。
要正确执行此操作，需要确保操作者有GetBucketObjectLockConfiguration权限。默认情况下只有桶的所有者可以执行此操作，也可以通过设置桶策略或用户策略授权给其他用户。
如果您打开了桶级WORM开关，但从未配置过桶级默认WORM策略，您依然可以使用此接口查看开关的打开情况。
请求消息样式
GET /?object-lock HTTP/1.1 Host: bucketname.obs.cn-north-4.myhuaweicloud.com Date: date Authorization: authorization Content-Type: application/xml Content-Length: length
请求消息参数
该请求消息中不使用消息参数。
请求消息头
该请求使用公共消息头，具体参见表3。
请求消息元素
该请求消息中不使用消息元素。
响应消息样式
HTTP/1.1 status_code
Date: date
Content-Type: application/xml
Content-Length: length
<?xml version="1.0" encoding="UTF-8"?>
<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。
响应消息元素
在此请求返回的响应消息体中包含的桶级默认WORM策略元素如下表1描述。
|
名称 |
描述 |
|---|---|
|
ObjectLockConfiguration |
桶级WORM配置的容器 类型：Container |
|
ObjectLockEnabled |
WORM开关状态，只能为Enabled 类型：String 示例：Enabled |
|
Rule |
桶级默认WORM策略的规则容器，如果从未配置过桶级默认WORM策略，则返回中不会包含此部分 类型：Container |
|
DefaultRetention |
桶级默认WORM策略的容器 类型：Container |
|
Mode |
默认的保护策略，当前仅支持合规模式"COMPLIANCE" 类型：String 示例：COMPLIANCE |
|
Days |
默认的保护天数，取值范围为1-36500天 类型：Integer 示例：1 |
|
Years |
默认的保护年数，取值范围为1-100年，一年实际上视为保护365天，不会考虑闰年 类型：Integer 示例：1 |
请求示例 1
打开了桶级WORM开关，未配置桶级默认WORM策略的情况
GET /?object-lock HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: WED, 01 Jul 2015 02:25:05 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw= Content-Length: 0
响应示例 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: 157 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <ObjectLockEnabled>Enabled</ObjectLockEnabled> </ObjectLockConfiguration>
请求示例 2
打开了桶级WORM开关，且配置了桶级默认WORM策略的情况：
GET /?object-lock HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: WED, 01 Jul 2015 02:25:05 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw= Content-Length: 0
响应示例 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: 157
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ObjectLockConfiguration xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/">
<ObjectLockEnabled>Enabled</ObjectLockEnabled>
<Rule>
<DefaultRetention>
<Mode>COMPLIANCE</Mode>
<Days>10</Days>
<Years>0</Years>
</DefaultRetention>
</Rule>
</ObjectLockConfiguration>
