您可以通过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\"}""