调用ExtendBucketWorm延长Bucket中文件的保留天数_对象存储(OSS)-阿里云帮助中心

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