オブジェクト・ストレージ保存ルールの作成
オブジェクト・ストレージ・バケットの保持ルールを作成します。
ルールが「保持ルール」リストに表示されます。
バケットの保持ルールを作成するには、oci os retention-rule createコマンドと必要なパラメータを使用します:
oci os retention-rule create --bucket-name bucket_name [OPTIONS]
例:
oci os retention-rule create --display-name LegalHold { "data": { "duration": null, "etag": "7f51ef6c-3fca-48f7-9060-c129911c1a50", "id": "5772c87f-6723-4ecc-b44c-bef86643be92", "time-created": "2020-03-25T14:53:20.792000+00:00", "time-modified": "2020-03-25T14:53:20.792000+00:00", "time-rule-locked": null }, "etag": "7f51ef6c-3fca-48f7-9060-c129911c1a50" }
保持ルールの表示名の指定
display-name
パラメータを含めて、ユーザー指定の保存ルールの名前を指定します。名前は、保持ルールの識別に役立ちます。例:oci os retention-rule create --bucket-name MyBucket --display-name LegalHold { "data": { "display-name": "LegalHold", "duration": null, "etag": "7f51ef6c-3fca-48f7-9060-c129911c1a50", "id": "5772c87f-6723-4ecc-b44c-bef86643be92", "time-created": "2020-03-25T14:53:20.792000+00:00", "time-modified": "2020-03-25T14:53:20.792000+00:00", "time-rule-locked": null }, "etag": "7f51ef6c-3fca-48f7-9060-c129911c1a50" }
期限付き保持ルールの作成
time-amount
およびtime-unit
パラメータを含めて、保持ルールが適用される期間を日数または年数で設定します。例:oci os retention-rule create --bucket-name MyBucket --time-amount 5 --time-unit days { "data": { "duration": { "time-amount": 5, "time-unit": "DAYS" }, "etag": "efb9178f-4213-49f7-878d-7bbe57decc0b", "id": "89f4ca0c-4ad9-4fa5-8005-95e7741c531c", "time-created": "2020-03-25T15:08:01.601000+00:00", "time-modified": "2020-03-25T15:08:01.601000+00:00", "time-rule-locked": null }, "etag": "efb9178f-4213-49f7-878d-7bbe57decc0b" }
時間量と単位を指定しない場合、時間制限はなく、バケット内のオブジェクトは無期限に保持されます。
保持ルールのロック
time-rule-locked
パラメータと、このルールがロックされ、バケットを削除することによってのみ削除できる日付タイムスタンプを含めます。例:oci os retention-rule create --bucket-name MyBucket --time-rule-locked 2017-09-15T20:30:00.123Z { "data": { "etag": "efb9178f-4213-49f7-878d-7bbe57decc0b", "id": "89f4ca0c-4ad9-4fa5-8005-95e7741c531c", "time-created": "2020-03-25T15:08:01.601000+00:00", "time-modified": "2020-03-25T15:08:01.601000+00:00", "time-rule-locked": 2017-09-15T20:30:00.123Z }, "etag": "efb9178f-4213-49f7-878d-7bbe57decc0b" }
このパラメータで使用できるサポートされている日付タイムスタンプ形式については、oci os retention-rule createを参照してください。
ルールがロックされると、期間の延長のみが許可され、他のプロパティは変更できません。ロック状態のルールでは、このプロパティを更新できません。期間が指定されていない場合に指定すると、エラーと見なされます。
CLIコマンドのパラメータおよび値の完全なリストは、CLIコマンド・リファレンスを参照してください。
CreateRetentionRule操作を実行して、バケットの保持ルールを作成します。