ExtendBucketWorm
ExtendBucketWorm用于延長已鎖定的合規(guī)保留策略對應(yīng)Bucket中Object的保留天數(shù)。
若指定用于延長Object保留天數(shù)對應(yīng)的WORM ID不存在,則返回404。
注意事項(xiàng)
當(dāng)基于時間的合規(guī)保留策略創(chuàng)建后,該策略默認(rèn)處于InProgress狀態(tài),且該狀態(tài)的有效期為24小時。在有效期24小時內(nèi),此策略對應(yīng)的Bucket數(shù)據(jù)處于保護(hù)狀態(tài)。
啟動合規(guī)保留策略24小時內(nèi):若此策略未提交鎖定,則Bucket所有者以及授權(quán)用戶可以刪除此策略;若該保留策略已提交鎖定,則不允許刪除此策略,且無法縮短策略保護(hù)周期,僅可以延長保護(hù)周期。
啟動合規(guī)保留策略24小時后:若超過24小時該保留策略未提交鎖定,則該策略自動失效。
若Bucket內(nèi)有文件處于保護(hù)周期內(nèi),那么您將無法刪除合規(guī)保留策略,同時也無法刪除Bucket。當(dāng)Bucket為空時,Bucket的所有者可以刪除該Bucket,從而間接刪除該Bucket的保留策略。
請求元素
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
ExtendWormConfiguration | 容器 | 是 | 不涉及 | 根節(jié)點(diǎn) 子節(jié)點(diǎn):RetentionPeriodInDays |
wormId | 字符串 | 是 | 1666E2CFB2B3418**** | 指定調(diào)用InitiateBucketWorm接口時自動生成的合規(guī)保留策略ID。 |
RetentionPeriodInDays | 正整數(shù) | 是 | 366 | 指定Object的保留天數(shù)。 取值范圍: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