保持ポリシーを作成するにはどうすればよいですか。 - Object Storage Service

保持ポリシーを作成します。

使用上の注意

保持ポリシーを作成するには、oss:InitiateBucketWorm権限が必要です。詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。
Object Storage Service (OSS) は、WORM (Write Once Read Many) 機能をサポートしており、特定の期間オブジェクトが削除または上書きされるのを防ぎます。バケットの時間ベースの保持ポリシーを設定できます。このポリシーには、1日から70年の保護期間があります。
保持ポリシーが作成後24時間以内にロックされない場合、保持ポリシーは無効になります。バケットに設定された保持ポリシーがロックされた後、バケットからオブジェクトを読み取ったり、バケットにオブジェクトをアップロードしたりできます。保持期間内にバケット内の保持ポリシーまたはオブジェクトを削除することはできません。オブジェクトは、保存期間が終了した後にのみ削除できます。保持ポリシーの詳細については、「保持ポリシー」をご参照ください。
バケットのバージョン管理の有効化と保持ポリシーの設定を同時に行うことはできません。バケットのバージョン管理が有効になっている場合、バケットの保持ポリシーを設定することはできません。バージョン管理の詳細については、「概要」をご参照ください。

コマンド構文

ossutil api initiate-bucket-worm --bucket value --initiate-worm-configuration value [flags]

パラメーター	必須	説明
-- bucket	String	バケットの名前です。
-- initiate-worm-configuration	String	リクエスト本文。

説明

initiate-bucket-wormコマンドは、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\"}"