GetBucketWorm - Object Storage Service

GetBucketWorm用於擷取指定儲存空間（Bucket）的合規保留原則資訊。

說明

若指定用來擷取Bucket的合規保留原則資訊對應的WORM ID不存在，則返回404。

注意事項

Object Storage Service支援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	字串	合規保留原則所處的狀態。可選值： InProgress：合規保留原則建立後，該策略預設處於“InProgress”狀態，且該狀態的有效期間為24小時。 Locked：合規保留原則處於鎖定狀態。
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>