全部產品
Search
文件中心

Object Storage Service:ExtendBucketWorm

更新時間:Jun 08, 2024

ExtendBucketWorm用於延長鎖定的合規保留原則對應Bucket中Object的保留天數。

說明

若指定用於延長Object保留天數對應的WORM ID不存在,則返回404。

注意事項

當基於時間的合規保留原則建立後,該策略預設處於InProgress狀態,且該狀態的有效期間為24小時。在有效期間24小時內,此策略對應的Bucket資料處於保護狀態。

  • 啟動合規保留原則24小時內:若此策略未提交鎖定,則Bucket所有者以及授權使用者可以刪除此策略;若該保留原則已提交鎖定,則不允許刪除此策略,且無法縮短策略保護周期,僅可以延長保護周期。

  • 啟動合規保留原則24小時後:若超過24小時該保留原則未提交鎖定,則該策略自動失效。

若Bucket內有檔案處於保護周期內,那麼您將無法刪除合規保留原則,同時也無法刪除Bucket。當Bucket為空白時,Bucket的所有者可以刪除該Bucket,從而間接刪除該Bucket的保留原則。

請求元素

名稱

類型

是否必選

樣本值

描述

ExtendWormConfiguration

容器

不涉及

根節點

子節點:RetentionPeriodInDays

wormId

字串

1666E2CFB2B3418****

指定調用InitiateBucketWorm介面時自動產生的合規保留原則ID。

RetentionPeriodInDays

正整數

366

指定Object的保留天數。

取值範圍:1~25,550。

樣本

  • 請求樣本

    POST /?wormId=1666E2CFB2B3418****&wormExtend HTTP/1.1
    Date: Thu, 15 May 2014 11:18:32 GMT
    Host: BucketName.oss.aliyuncs.com
    Authorization: OSS qn6q**************:77Dv**************** 
    
    <ExtendWormConfiguration>
      <RetentionPeriodInDays>366</RetentionPeriodInDays>
    </ExtendWormConfiguration>
  • 返回樣本

    HTTP/1.1 200 OK
    Server: AliyunOSS
    Date: Thu, 15 May 2014 11:18:32 GMT
    Content-Length: 0
    Connection: keep-alive
    x-oss-request-id: 5C06A3B67B8B5A3DA422299D
    x-oss-server-time: 122