Object Storage Service (OSS) バケット内のオブジェクトの保持期間を延長します。保持ポリシーはロックされています。
リクエストで指定された保持ポリシー ID が存在しない場合、OSS は HTTP ステータスコード 404 を返します。
使用方法
デフォルトでは、時間ベースの保持ポリシーは、バケットに対してポリシーが作成された後、InProgress 状態になります。この状態は 24 時間有効です。 24 時間以内に、保持ポリシーはバケット内のデータを保護します。
保持ポリシーが有効になってから 24 時間以内: 保持ポリシーがロックされていない場合、バケットオーナーと承認されたユーザーはこのポリシーを削除できます。保持ポリシーがロックされている場合、ポリシーの保護期間を短縮したり、ポリシーを削除したりすることはできません。保護期間は延長のみ可能です。
保持ポリシーが有効になってから 24 時間後: 保持ポリシーがロックされていない場合、ポリシーは無効になります。
バケットに保護期間内のオブジェクトが含まれている場合、バケットまたはその保持ポリシーを削除することはできません。バケットが削除されると、バケットの保持ポリシーも削除されます。バケットが空の場合、バケットオーナーのみがバケットを削除できます。
リクエスト要素
要素 | タイプ | 必須 | 例 | 説明 |
ExtendWormConfiguration | コンテナ | はい | 該当なし | ルートノード。 子ノード: RetentionPeriodInDays |
wormId | 文字列 | はい | 1666E2CFB2B3418**** | InitiateBucketWorm 操作が呼び出されたときに自動的に生成される保持ポリシーの ID です。 |
RetentionPeriodInDays | 正の整数 | はい | 366 | オブジェクトを保持する必要がある日数。 有効な値: 1 ～ 25550 。 |
例
リクエストの例
POST /?wormId=1666E2CFB2B3418****&wormExtend HTTP/1.1 Date: Thu, 17 Apr 2025 11:18:32 GMT Host: BucketName.oss.aliyuncs.com Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e <ExtendWormConfiguration> <RetentionPeriodInDays>366</RetentionPeriodInDays> </ExtendWormConfiguration>レスポンスの例
HTTP/1.1 200 OK Server: AliyunOSS Date: Thu, 15 May 2014 11:18:32 GMT Content-Length: 0 Connection: keep-alive x-oss-request-id: 5C06A3B67B8B5A3DA422299D x-oss-server-time: 122
OSS SDK
次のプログラミング言語の OSS SDK を使用して、ExtendBucketWorm 操作を呼び出すことができます。
ossutil
ExtendBucketWorm 操作に対応する ossutil コマンドについては、extend-bucket-worm をご参照ください。