PutBucketObjectWormConfiguration を使用して、バケットのオブジェクトレベルの保持ポリシーを有効にする - Object Storage Service

PutBucketObjectWormConfiguration を使用して、バケットのオブジェクトレベルの保持ポリシー (ObjectWorm) を有効にし、オプションでデフォルトの保持ポリシーを設定します。この操作は元に戻すことができません。バケットに対して ObjectWorm を一度有効にすると、無効にすることはできません。

注意事項

重要

この機能は現在、招待プレビュー段階です。この機能を使用するには、テクニカルサポートにお問い合わせの上、有効化を申請してください。この機能は現在、中国 (杭州)、中国 (成都)、中国 (深セン)、中国 (広州)、中国 (青島)、中国 (北京)、中国 (ウランチャブ)、中国 (河源)、中国 (香港)、ドイツ (フランクフルト)、日本 (東京)、韓国 (ソウル)、シンガポール、マレーシア (クアラルンプール)、インドネシア (ジャカルタ)、フィリピン (マニラ)、タイ (バンコク)、サウジアラビア (リヤド)、UAE (ドバイ) の各リージョンでのみサポートされています。

この操作は元に戻すことができません。バケットのオブジェクトレベルの保持ポリシーを有効にすると、その ObjectWorm 機能やバージョン管理機能を無効にすることはできません。
この操作を呼び出す前に、バケットのバージョン管理を有効にする必要があります。そうしない場合、操作はエラーを返します。
ObjectWorm は、バケットレベルの保持ポリシー (BucketWorm) と相互排他的です。バケットレベルの保持ポリシーがバケットですでに有効になっている場合、呼び出しは失敗し、エラーが返されます。
デフォルトの保持ポリシーの設定はオプションです。デフォルトの保持ポリシーを設定すると、システムはバケットにアップロードされるすべての新しいオブジェクトに自動的に適用します。このポリシーは既存のオブジェクトには適用されません。既存のオブジェクトに保持ポリシーを適用するには、PutObjectRetention 操作を呼び出します。
ObjectWorm を有効にすると、追加アップロードのサポートが無効になります。
ユーザーにオブジェクト保持ポリシーの管理を許可するには、oss:PutObjectRetention および oss:GetObjectRetention の権限を付与する必要があります。

リクエスト構文

PUT /?objectWorm HTTP/1.1
Content-MD5: ContentMD5
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

パラメーター	タイプ	必須	例	説明
Content-MD5	String	はい	B2M2Y8AsgTpgAmY7PhC****	リクエストボディの Base64 でエンコードされた MD5 ハッシュ。OSS はこのヘッダーを使用してデータの整合性を検証します。
Content-Length	正の整数	はい	188	リクエストボディの長さ (バイト単位)。

リクエスト要素

パラメーター	タイプ	必須	例	説明
ObjectWormConfiguration	コンテナ	はい	N/A	バケットのオブジェクトレベルの保持ポリシー設定のコンテナです。親要素：なし子要素：ObjectWormEnabled、Rule
ObjectWormEnabled	String	はい	Enabled	オブジェクトレベルの保持ポリシーを有効にするかどうかを指定します。この値は `Enabled` である必要があります。親要素：ObjectWormConfiguration
Rule	コンテナ	いいえ	N/A	バケットのデフォルトのオブジェクトレベル保持ポリシーのコンテナです。親要素：ObjectWormConfiguration 子要素：DefaultRetention
DefaultRetention	コンテナ	いいえ	N/A	デフォルトの保持ポリシーのコンテナです。親要素：Rule 子要素：Mode、Days、Years
Mode	String	いいえ	COMPLIANCE	オブジェクトレベルの保持ポリシーのデフォルトの保持モード。有効な値は次のとおりです： COMPLIANCE (コンプライアンスモード)：保持期間内は、ルートユーザーを含むどのユーザーも、保護されたオブジェクトバージョンを削除または上書きすることはできません。親要素：DefaultRetention
Days	正の整数	いいえ	1	デフォルトの保存期間 (日数)。有効値: 1～36500。`Days` または `Years` のいずれか一方を指定する必要があります。親ノード：DefaultRetention
Years	正の整数	いいえ	1	デフォルトの保持期間 (年数)。有効な値：1～100。`Days` または `Years` のいずれかの値を設定できますが、両方を設定することはできません。親要素：DefaultRetention

例

例 1：デフォルトポリシーで ObjectWorm を有効にする

次の例は、バケットの ObjectWorm を有効にし、オブジェクトをコンプライアンスモードで 1 日間保護するデフォルトの保持ポリシーを設定する方法を示しています。

リクエスト例

PUT /?objectWorm HTTP/1.1
Date: Thu, 17 Mar 2026 11:18:32 GMT
Content-Length: 188
Content-Type: application/xml
Content-MD5: B2M2Y8AsgTpgAmY7PhC****
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20260317/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d****

<?xml version="1.0" encoding="UTF-8"?>
<ObjectWormConfiguration>
  <ObjectWormEnabled>Enabled</ObjectWormEnabled>
  <Rule>
    <DefaultRetention>
      <Mode>COMPLIANCE</Mode>
      <Days>1</Days>
    </DefaultRetention>
  </Rule>
</ObjectWormConfiguration>

レスポンス例

HTTP/1.1 200 OK
x-oss-request-id: 5374A2880232A65C2300****
Date: Thu, 17 Mar 2026 11:18:32 GMT
Content-Length: 0
Server: AliyunOSS

例 2：デフォルトポリシーなしで ObjectWorm を有効にする

次の例は、デフォルトの保持ポリシーを設定せずにバケットの ObjectWorm を有効にする方法を示しています。後で PutObjectRetention を呼び出して、個々のオブジェクトに保持ポリシーを設定できます。

リクエスト例

PUT /?objectWorm HTTP/1.1
Date: Thu, 17 Mar 2026 11:18:32 GMT
Content-Length: 102
Content-Type: application/xml
Content-MD5: C3N3Z9BthUpgBnZ8QiD****
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20260317/cn-hangzhou/oss/aliyun_v4_request,Signature=****

<?xml version="1.0" encoding="UTF-8"?>
<ObjectWormConfiguration>
  <ObjectWormEnabled>Enabled</ObjectWormEnabled>
</ObjectWormConfiguration>

レスポンス例

HTTP/1.1 200 OK
x-oss-request-id: 6485B3990232A65C3400****
Date: Thu, 17 Mar 2026 11:20:15 GMT
Content-Length: 0
Server: AliyunOSS

エラーコード

エラーコード	HTTP ステータスコード	説明
InvalidBucketState	409	バケットでバージョン管理が有効になっていないため、ObjectWorm を有効にできません。バージョン管理を有効にしてから、もう一度お試しください。
BucketWormAlreadyEnabled	409	バケットレベルの保持ポリシー (BucketWorm) がバケットですでに有効になっています。オブジェクトレベルの保持ポリシー (ObjectWorm) を同時に有効にすることはできません。