3.4.4. S3 put object lock
put object lock API は、選択したバケットにロック設定を配置します。オブジェクトロックを使用すると、Write-Once-Read-Many (WORM) モデルを使用してオブジェクトを格納できます。オブジェクトロックは、オブジェクトが一定期間または無期限に削除または上書きされないようにします。Object Lock 設定に指定されるルールは、デフォルトで選択されるバケットにあるすべての新規オブジェクトに適用されます。
重要
バケットを作成するときにオブジェクトロックを有効にします。有効にしないと、操作が失敗します。
構文
PUT /BUCKET?object-lock HTTP/1.1
例
PUT /testbucket?object-lock HTTP/1.1
リクエストエンティティー
ObjectLockConfiguration- 説明
- 要求のコンテナー。
- 型
- コンテナー
- 必須
- はい
ObjectLockEnabled- 説明
- このバケットにオブジェクトロック設定が有効になっているかどうかを示します。
- 型
- String
- 必須
- はい
Rule- 説明
- 指定されたバケットの位置にあるオブジェクトロックルール。
- 型
- コンテナー
- 必須
- いいえ
DefaultRetention- 説明
- 指定されたバケットに設定される新規オブジェクトに適用されるデフォルトの保持期間。
- 型
- コンテナー
- 必須
- いいえ
Mode- 説明
- デフォルトのオブジェクトのロック保持モード。有効な値は GOVERNANCE/COMPLIANCE です。
- 型
- コンテナー
- 必須
- はい
Days- 説明
- デフォルトの保持期間に指定される日数。
- 型
- Integer
- 必須
- いいえ
Years- 説明
- デフォルトの保持期間に指定されるの年数。
- 型
- Integer
- 必須
- いいえ
HTTP レスポンス
400- ステータスコード
-
MalformedXML - 説明
- XML は適していません。
409- ステータスコード
-
InvalidBucketState - 説明
- バケットオブジェクトのロックが有効になっていません。