バケット内のオブジェクトの保持期間を延長
使用上の注意
バケット内のオブジェクトの保持期間を延長するには、
oss:ExtendBucketWorm
権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。デフォルトでは、バケットに対してポリシーが作成された後、時間ベースのポリシーはInProgress状態になります。 ポリシーは24時間この状態のままです。 24時間以内に、保持ポリシーはバケット内のデータを保護します。
保持ポリシーが有効になった後の24時間ウィンドウ: 保持ポリシーがロックされていない場合、バケット所有者と許可されたユーザーはこのポリシーを削除できます。 保持ポリシーがロックされている場合、ポリシーは削除できず、保持ポリシーで指定された保持期間のみを延長できます。
保持ポリシーが有効になってから24時間後: 保持ポリシーがロックされていない場合、ポリシーは無効になります。
保護期間内のオブジェクトがバケットに含まれている場合、バケットまたはその保持ポリシーは削除できません。 バケットが削除されると、バケットの保持ポリシーも削除されます。 バケットが空の場合、バケット所有者のみがバケットを削除できます。
コマンド構文
ossutil api extend-bucket-worm --bucket value --worm-id value --extend-worm-configuration value [flags]
パラメーター | 必須 | 説明 |
-- bucket | String | バケットの名前です。 |
-- extend-worm-configuration | String | 保持ポリシーの設定を格納するコンテナー。 |
-- worm-id | String | 保持ポリシーのID。 |
-- extend-worm-构成
-- extend-worm-configurationオプションは、XMLおよびJSON形式をサポートします。 オプションの値に "file://" プレフィックスが含まれている場合、ossutilは指定されたファイルから設定を読み取ります。
XML 形式:
<ExtendWormConfiguration> <RetentionPeriodInDays>integer</RetentionPeriodInDays> </ExtendWormConfiguration>
JSON 形式:
{ "RetentionPeriodInDays": integer }
詳細については、「コマンドラインオプション」をご参照ください。
例
「123」保持ポリシーで保護されているオブジェクトの保持期間を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\"}""