如何延長儲存空間中檔案的保留天數 - Object Storage Service

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