延长存储空间中文件的保留天数

您可以通过API级命令延长存储空间中文件的保留天数。

注意事项

  • 要延长存储空间中文件的保留天数,您必须有oss:ExtendBucketWorm权限。具体操作,请参见为RAM用户授权自定义的权限策略

  • 当基于时间的合规保留策略创建后,此策略默认处于InProgress状态,且该状态的有效期为24小时。在有效期24小时内,此策略对应的Bucket数据处于保护状态。

    • 启动合规保留策略24小时内:若此策略未提交锁定,则Bucket所有者以及授权用户可以删除此策略;若此保留策略已提交锁定,则不允许删除此策略,且无法缩短策略保护周期,仅可以延长保护周期。

    • 启动合规保留策略24小时后:若超过24小时此保留策略未提交锁定,则此策略自动失效。

  • 若Bucket内有文件处于保护周期内,那么您将无法删除合规保留策略,同时也无法删除Bucket。当Bucket为空时,Bucket的所有者可以删除该Bucket,从而间接删除该Bucket的保留策略。

命令格式

 ossutil api extend-bucket-worm --bucket value --worm-id value --extend-worm-configuration value [flags]

参数

类型

说明

--bucket

string

Bucket名称。

--extend-worm-configuration

string

保存合规保留策略的容器。

--worm-id

string

合规保留策略的ID。

--extend-worm-configuration

--extend-worm-configuration配置选项既支持XML语法也支持JSON语法。当选项值包含file://前缀时,表示从文件中读取配置。

  • XML语法:

    <ExtendWormConfiguration>
      <RetentionPeriodInDays>integer</RetentionPeriodInDays>
    </ExtendWormConfiguration>
  • JSON语法:

    {
      "RetentionPeriodInDays": integer
    }
说明

关于支持的全局命令行选项,请参见支持的全局命令行选项

使用示例

延长已锁定的合规ID为123的保留策略对应Bucket中Object的保留天数为366。

  • 使用XML配置文件,extend-worm-configuration.xml内容如下:

    <?xml version="1.0" encoding="UTF-8"?>
    <ExtendWormConfiguration>
      <RetentionPeriodInDays>366</RetentionPeriodInDays>
    </ExtendWormConfiguration>

    命令示例如下:

    ossutil api extend-bucket-worm --bucket examplebucket --worm-id 123 --extend-worm-configuration file://extend-worm-configuration.xml
  • 使用JSON配置文件,extend-worm-configuration.json内容如下:

    {
            "RetentionPeriodInDays": "366"
    }

    命令示例如下:

    ossutil api extend-bucket-worm --bucket examplebucket --worm-id 123 --extend-worm-configuration file://extend-worm-configuration.json
  • 使用JSON配置参数,命令示例如下:

    ossutil api extend-bucket-worm --bucket examplebucket --worm-id 123 --extend-worm-configuration " "{\"RetentionPeriodInDays\":\"366\"}""