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已開啟版本控制功能，則無法再配置保留原則。關於版本控制功能更多資訊，請參見版本控制概述。

請求元素

SDK

此介面所對應的各語言SDK如下：

• Java

• Python V2

• Go V2

• Node.js

• C++

• PHP V2

命令列工具ossutil

InitiateBucketWorm介面所對應的ossutil命令，請參見initiate-bucket-worm。

樣本

• 請求樣本

  POST /?worm HTTP/1.1
  Date: Thu, 17 Apr 2025 11:18:32 GMT
  Content-Length：556
  Content-Type: application/xml
  Host: BucketName.oss.aliyuncs.com
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  
  <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