如何建立合規保留原則 - Object Storage Service

您可以通過API級命令建立合規保留原則。

注意事項

要建立合規保留原則，您必須有oss:InitiateBucketWorm許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。
Object Storage Service支援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配置選項既支援XML文法也支援JSON文法：

XML文法：

<InitiateWormConfiguration>
  <RetentionPeriodInDays>integer</RetentionPeriodInDays>
</InitiateWormConfiguration>

說明

關於支援的全域命令列選項，請參見支援的全域命令列選項。

為儲存空間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\"}"