如何延长存储空间中文件的保留天数_对象存储(OSS)-阿里云帮助中心

您可以通过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]

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

XML语法：

<ExtendWormConfiguration>
  <RetentionPeriodInDays>integer</RetentionPeriodInDays>
</ExtendWormConfiguration>

说明

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

延长已锁定的合规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\"}""