GetBucketWorm用于獲取指定存儲空間（Bucket）的合規保留策略信息。
說明
若指定用來獲取Bucket的合規保留策略信息對應的WORM ID不存在，則返回404。
注意事項
對象存儲OSS支持WORM（Write Once Read Many）特性，允許您以不可刪除、不可篡改的方式保存和使用數據。OSS允許針對Bucket設置基于時間的合規保留策略，保護周期為1天到70年。
當合規保留策略鎖定后，您可以在Bucket中上傳和讀取文件（Object），但是在Object的保留時間到期之前，不允許刪除Object及合規保留策略。Object的保留時間到期后，才可以刪除Object。
請求頭
此接口僅涉及公共請求頭，詳情請參見公共請求頭（Common Request Headers）。
響應頭
此接口僅涉及公共響應頭，詳情請參見公共響應頭（Common Response Headers）。
響應元素
名稱 | 類型 | 描述 |
WormConfiguration | 容器 | 根節點。 子節點：WormId、State、RetentionPeriodInDays、CreationDate |
WormId | 字符串 | 合規保留策略的ID。 |
State | 字符串 | 合規保留策略所處的狀態。 可選值：
|
RetentionPeriodInDays | 正整數 | Object的指定保留天數。 |
CreationDate | 字符串 | 合規保留策略的創建時間。 |
示例
請求示例
GET /?worm HTTP/1.1 Date: Fri, 16 Oct 2020 11:18:32 GMT Host: BucketName.oss.aliyuncs.com Authorization: SignatureValue返回示例
HTTP/1.1 200 OK x-oss-request-id: 5374A2880232A65C2300**** Date: Fri, 16 Oct 2020 11:18:32 GMT Content-Type: application/xml Content-Length: length <WormConfiguration> <WormId>1666E2CFB2B3418****</WormId> <State>Locked</State> <RetentionPeriodInDays>1</RetentionPeriodInDays> <CreationDate>2020-10-15T15:50:32</CreationDate> </WormConfiguration>
文檔內容是否對您有幫助？