調用GetBucketObjectWormConfiguration擷取Bucket的對象層級保留原則配置 - Object Storage Service

調用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>