调用GetBucketObjectWormConfiguration获取Bucket的对象级别保留策略配置-对象存储(OSS)-阿里云帮助中心

调用GetBucketObjectWormConfiguration接口获取指定Bucket的对象级别保留策略（ObjectWorm）配置信息，包括是否已启用以及默认保留策略设置。

注意事项

调用该接口需要具备oss:GetBucketObjectWormConfiguration权限。
如果Bucket未开启对象级别保留策略，调用将返回404错误。

请求语法

GET /?objectWorm HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

响应元素

名称	类型	示例值	描述
ObjectWormConfiguration	容器	不涉及	Bucket对象级别保留策略配置的容器。子节点：ObjectWormEnabled、Rule
ObjectWormEnabled	字符串	Enabled	对象级别保留策略是否已启用。父节点：ObjectWormConfiguration
Rule	容器	不涉及	默认保留策略的容器。如果未设置默认策略，则不返回此元素。父节点：ObjectWormConfiguration 子节点：DefaultRetention
DefaultRetention	容器	不涉及	默认保留策略详情的容器。父节点：Rule 子节点：Mode、Days或Years
Mode	字符串	COMPLIANCE	默认保留模式。COMPLIANCE表示合规模式。父节点：DefaultRetention
Days	正整数	1	默认保留天数。与Years互斥，仅返回其中一个。父节点：DefaultRetention
Years	正整数	1	默认保留年数。与Days互斥，仅返回其中一个。父节点：DefaultRetention

示例

请求示例

GET /?objectWorm HTTP/1.1
Date: Thu, 17 Mar 2026 11:18:32 GMT
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20260317/cn-hangzhou/oss/aliyun_v4_request,Signature=****

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 5374A2880232A65C2300****
Date: Thu, 17 Mar 2026 11:18:32 GMT
Content-Type: application/xml
Transfer-Encoding: chunked
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<ObjectWormConfiguration>
  <ObjectWormEnabled>Enabled</ObjectWormEnabled>
  <Rule>
    <DefaultRetention>
      <Mode>COMPLIANCE</Mode>
      <Days>1</Days>
    </DefaultRetention>
  </Rule>
</ObjectWormConfiguration>