保持ポリシーがロックされているObject Storage Service (OSS) バケット内のオブジェクトの保持期間を延長します。
リクエストに指定された保持ポリシーIDが存在しない場合、OSSはHTTPステータスコード404を返します。
使用上の注意
デフォルトでは、時間ベースの保持ポリシーは、バケットに対してポリシーが作成された後はInProgress状態になります。 州は24時間有効です。 24時間以内に、保持ポリシーはバケット内のデータを保護します。
保持ポリシーが有効になった後の24時間ウィンドウ: 保持ポリシーがロックされていない場合、バケット所有者と許可されたユーザーはこのポリシーを削除できます。 保持ポリシーがロックされている場合、ポリシーの保護期間を短縮できず、ポリシーを削除できません。 保護期間は延長することしかできません。
保持ポリシーが有効になってから24時間後: 保持ポリシーがロックされていない場合、ポリシーは無効になります。
保護期間内のオブジェクトがバケットに含まれている場合、バケットまたはその保持ポリシーは削除できません。 バケットが削除されると、バケットの保持ポリシーも削除されます。 バケットが空の場合、バケット所有者のみがバケットを削除できます。
リクエスト要素
要素 | データ型 | 必須 | 例 | 説明 |
ExtendWormConfiguration | Container | 必須 | N/A | ルートノード。 子ノード: RetentionPeriodInDays |
wormId | String | 必須 | 1666E2CFB2B3418 **** | InitiateBucketWorm操作が呼び出されたときに自動的に生成される保持ポリシーのID。 |
RetentionPeriodInDays | 正の整数 | 必須 | 366 | オブジェクトを保持する必要がある日数。 有効な値: 1 ~ 25550 |
例
リクエストの例
POST /?wormId=1666E2CFB2B3418 ****&wormExtend HTTP/1.1 日付: 5月15日木曜日11:18:32 GMT 2014 ホスト: BucketName.oss.aliyuncs.com 承認: OSS nxj7dtlhcyl5hp ****:COS3OQkfQPnKmYZTEHYv2 **** <ExtendWormConfiguration> <RetentionPeriodInDays>366</RetentionPeriodInDays> </ExtendWormConfiguration>レスポンスの例
HTTP/1.1 200 OK サーバー: AliyunOSS 日付: 5月15日木曜日11:18:32 GMT 2014 コンテンツ長: 0 接続: キープアライブ x-oss-request-id: 5C06A3B67B8B5A3DA422299D x-oss-server-time: 122