この操作では、保持ポリシーを作成します。
使用上の注意
OSS は、指定された期間にわたってオブジェクトが削除または上書きされないようにする Write Once Read Many (WORM) 方式をサポートしています。 バケットの時間ベースの保持ポリシーを設定できます。 このポリシーには、1日から70年の保護期間があります。
- バケットの保持ポリシーが作成されてから24時間以内に、保持ポリシーがまだロックされていない場合、バケット所有者と許可されたユーザーはポリシーを変更または削除できます。 保持ポリシーがロックされている場合、バケットからオブジェクトを読み取り、バケットにオブジェクトをアップロードできます。 ただし、保持期間内のオブジェクトまたは保持ポリシーは削除できません。 保持期間が終了した後にのみオブジェクトを削除できます。 保持ポリシーの詳細については、「保持ポリシー」をご参照ください。
- 保持ポリシーまたはミラーリングベースのback-to-originで同時にバージョン管理を構成することはできません。 バージョン管理の詳細については、「概要」をご参照ください。
リクエスト要素
| 要素 | データ型 | 必須 | 説明 |
| InitiateWormConfiguration | Container | 必須 | ルートノード。 子ノード: RetentionPeriodInDays |
| RetentionPeriodInDays | 正の整数 | 必須 | オブジェクトを保持できる日数。 |
例
- POST /? リクエスト
のサンプル ワームHTTP/1.1 日付: 5月15日木曜日11:18:32 GMT 2014 コンテンツ-長さ: 556 Content-Type: application/xml ホスト: BucketName.oss.aliyuncs.com 承認: OSS nxj7dtlhcyl5hp ****:COS3OQkfQPnKmYZTEHYv2 **** <InitiateWormConfiguration> <RetentionPeriodInDays>365</RetentionPeriodInDays> </InitiateWormConfiguration> - HTTP/1.1 200のサンプル応答
2014OK x-oss-request-id: 5374A2880232A65C2300 **** x-oss-worm-id: 1666E2CFB2B3418 **** 日付: 5月15日木曜日11:18:32 GMT