您可以通過API級命令新建合規保留策略。
注意事項
要新建合規保留策略,您必須有
oss:InitiateBucketWorm
權限。具體操作,請參見為RAM用戶授權自定義的權限策略。對象存儲OSS支持WORM(Write Once Read Many)特性,允許以不可刪除、不可篡改的方式保存和使用數據。OSS允許針對存儲空間(Bucket)設置基于時間的合規保留策略,保護周期為1天到70年。
當基于時間的合規保留策略創建24小時后未提交鎖定,則該策略自動失效。當合規保留策略鎖定后,您可以在Bucket中上傳和讀取文件(Object),但是在Object的保留時間到期之前,不允許刪除Object及合規保留策略。Object的保留時間到期后,才可以刪除Object。關于合規保留策略的更多信息,請參見保留策略。
同一個Bucket中,版本控制和合規保留策略無法同時配置。如果Bucket已開啟版本控制功能,則無法再配置保留策略。關于版本控制功能更多信息,請參見版本控制概述。
命令格式
ossutil api initiate-bucket-worm --bucket value --initiate-worm-configuration value [flags]
參數 | 類型 | 說明 |
--bucket | string | Bucket名稱。 |
--initiate-worm-configuration | string | 請求體。 |
initiate-bucket-worm 命令對應API接口InitiateBucketWorm。關于API中的具體參數含義,請參見InitiateBucketWorm。
--initiate-worm-configuration
--initiate-worm-configuration配置選項既支持XML語法也支持JSON語法:
XML語法:
<InitiateWormConfiguration> <RetentionPeriodInDays>integer</RetentionPeriodInDays> </InitiateWormConfiguration>
JSON語法:
{ "RetentionPeriodInDays": integer }
關于支持的全局命令行選項,請參見支持的全局命令行選項。
使用示例
為存儲空間examplebucket新建一條合規保留策略。
使用XML配置文件,initiate-worm-configuration.xml內容如下:
<?xml version="1.0" encoding="UTF-8"?> <InitiateWormConfiguration> <RetentionPeriodInDays>365</RetentionPeriodInDays> </InitiateWormConfiguration>
命令示例如下:
ossutil api initiate-bucket-worm --bucket examplebucket --initiate-worm-configuration file://initiate-worm-configuration.xml
使用JSON配置文件,initiate-worm-configuration.json內容如下:
{ "RetentionPeriodInDays": "365" }
命令示例如下:
ossutil api initiate-bucket-worm --bucket examplebucket --initiate-worm-configuration file://initiate-worm-configuration.json
使用JSON配置參數,命令示例如下:
ossutil api initiate-bucket-worm --bucket examplebucket --initiate-worm-configuration "{\"RetentionPeriodInDays\":\"365\"}"