InitiateBucketWorm - Object Storage Service

調用InitiateBucketWorm介面建立一條合規保留原則。

注意事項

Object Storage Service支援WORM（Write Once Read Many）特性，允許以不可刪除、不可篡改的方式儲存和使用資料。OSS允許針對儲存空間（Bucket）設定基於時間的合規保留原則，保護周期為1天到70年。

當基於時間的合規保留原則建立24小時後未提交鎖定，則該策略自動失效。當合規保留原則鎖定後，您可以在Bucket中上傳和讀取檔案（Object），但是在Object的保留時間到期之前，不允許刪除Object及合規保留原則。Object的保留時間到期後，才可以刪除Object。關於合規保留原則的更多資訊，請參見保留原則。
同一個Bucket中，版本控制和合規保留原則無法同時配置。如果Bucket已開啟版本控制功能，則無法再配置保留原則。關於版本控制功能更多資訊，請參見版本控制概述。

請求元素

名稱

類型

是否必須

描述

InitiateWormConfiguration

容器

是

根節點

子節點：RetentionPeriodInDays

RetentionPeriodInDays

正整數

是

指定Object保留天數。

樣本

請求樣本

POST /?worm HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Content-Length：556
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************

<InitiateWormConfiguration>
  <RetentionPeriodInDays>365</RetentionPeriodInDays>
</InitiateWormConfiguration>

返回樣本

HTTP/1.1 200 OK
x-oss-request-id: 5374A2880232A65C2300****
x-oss-worm-id: 1666E2CFB2B3418****
Date: Thu, 15 May 2014 11:18:32 GMT