InitiateBucketWorm 操作を呼び出して、保持ポリシーを作成します。
使用上の注意
Object Storage Service (OSS) は、Write Once Read Many (WORM) 機能をサポートしています。この機能により、データの削除や変更が防止されます。バケットに時間ベースの保持ポリシーを設定できます。保持期間は 1 日から 70 年まで設定できます。
時間ベースの保持ポリシーは、作成後 24 時間以内にロックされない場合、自動的に無効になります。保持ポリシーがロックされると、バケットへのオブジェクトのアップロードとバケットからのオブジェクトの読み取りはできますが、保持期間が切れるまでオブジェクトや保持ポリシーを削除することはできません。保持ポリシーの詳細については、「保持ポリシー」をご参照ください。
同じバケットにバージョン管理と保持ポリシーを設定できます。バケットでバージョン管理が有効になっている必要があります。
リクエスト要素
名前 | タイプ | 必須 | 説明 |
InitiateWormConfiguration | コンテナ | はい | ルートノード。 子ノード：RetentionPeriodInDays |
RetentionPeriodInDays | 正の整数 | はい | オブジェクトの保持期間 (日数)。 |
SDK
この API で利用可能な SDK は次のとおりです。
ossutil
対応する ossutil コマンドの詳細については、「initiate-bucket-worm」をご参照ください。
例
リクエストの例
POST /?worm HTTP/1.1 Date: Thu, 17 Apr 2025 11:18:32 GMT Content-Length: 556 Content-Type: application/xml Host: BucketName.oss.aliyuncs.com Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e <InitiateWormConfiguration> <RetentionPeriodInDays>365</RetentionPeriodInDays> </InitiateWormConfiguration>レスポンスの例
HTTP/1.1 200 OK x-oss-request-id: 5374A2880232A65C2300**** x-oss-worm-id: 1666E2CFB2B3418**** Date: Thu, 15 May 2014 11:18:32 GMT