功能介绍

获取该桶设置的桶级默认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



    Enabled
    
       
          integer
          COMPLIANCE
          integer
       
    

响应消息头

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

响应消息元素

在此请求返回的响应消息体中包含的桶级默认WORM策略元素如下表1描述。

表1 桶级默认WORM策略元素

名称	描述
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

错误响应消息

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

表2

错误码	描述	HTTP状态码
InvalidRequest	目标桶没有开启桶级WORM开关	400

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

请求示例 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

  Enabled

请求示例 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


<ObjectLockConfiguration xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/">
  Enabled
  
    
      COMPLIANCE
      10
      0
    
  

父主题： 桶的高级配置

同意关联代理商云淘科技，购买华为云产品更优惠（QQ 78315851）

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