更新时间: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


    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
    
  

相关文档

网站地图