全部产品
Search
文档中心

对象存储 OSS:ExtendBucketWorm

更新时间:Aug 23, 2023

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 nxj7dtlhcyl5hp****:COS3OQkfQPnKmYZTEHYv2**** 
    
    <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