全部產品
Search
文件中心

Object Storage Service:InitiateBucketWorm

更新時間:Jun 19, 2024

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