ossutil で WORM 保持ポリシーを開始 - OSS

バケットに対して、Write Once Read Many（WORM）保持ポリシーを作成します。このポリシーにより、指定された保持期間（1 日～70 年）の間、オブジェクトの削除および上書きが防止されます。

重要

一度ロックされると、保持ポリシーは削除または期間の短縮ができません。保持期間を確認したうえで、ロック操作を行ってください。

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

oss:InitiateBucketWorm 権限を付与されていること。詳細については、「RAM ユーザーへのカスタムポリシーのアタッチ」をご参照ください。
バージョン管理が無効化されたバケットであること。同一バケット上で、バージョン管理と保持ポリシーを併用することはできません。

新しく作成された保持ポリシーはアンロック状態です。24 時間以内にロックしない場合、ポリシーは無効になります。
ポリシーがロックされた後は、バケットからのオブジェクト読み取りおよびオブジェクトのアップロードは可能ですが、保持期間が終了するまで、オブジェクトおよびポリシーの削除はできません。
保持ポリシーの仕組みについての背景情報については、「保持ポリシー」をご参照ください。

ossutil api initiate-bucket-worm --bucket <bucket-name> --initiate-worm-configuration <config> [flags]

initiate-bucket-worm は、InitiateBucketWorm API オペレーションの ossutil における同等のコマンドです。利用可能なフラグについては、「コマンドラインオプション」をご参照ください。

パラメーター	型	説明
`--bucket`	string	バケット名。
`--initiate-worm-configuration`	string	保持ポリシーの構成。XML または JSON 形式で指定できます（以下参照）。

XML 形式：

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

JSON 形式：

{
  "RetentionPeriodInDays": integer
}

RetentionPeriodInDays には、1 日～70 年（整数値）の任意の値を指定できます。

以下の例では、examplebucket に対して 365 日間の保持ポリシーを作成します。

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 構成ファイルを使用する場合：

{
  "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\"}"

ポリシーを作成した後は、保護を有効化するために24時間以内にロックしてください。詳細については、「保持ポリシーのロック」をご参照ください。