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