この操作では、指定されたバケットに設定された保持ポリシーを照会します。
注 リクエストのIDで指定された保持ポリシーが存在しない場合、OSSは404を返します。
使用上の注意
OSS は、指定された期間にわたってオブジェクトが削除または上書きされないようにする Write Once Read Many (WORM) 方式をサポートしています。 バケットの時間ベースの保持ポリシーを設定できます。 保持ポリシーには、1日から70年の範囲の保持期間があります。
バケットに設定された保持ポリシーがロックされた後、バケットからオブジェクトを読み取ったり、バケットにオブジェクトをアップロードしたりできます。 ただし、バケット内の保持ポリシーとオブジェクトは、保持期間内に削除することはできません。 バケット内のオブジェクトは、保持期間が終了した後にのみ削除できます。
リクエストヘッダー
GetBucketWormリクエストには、共通リクエストヘッダーのみが含まれます。 詳細については、「共通リクエストヘッダー」をご参照ください。
レスポンスヘッダー
GetBucketWormリクエストに対する応答には、共通の応答ヘッダーのみが含まれます。 詳細については、「共通レスポンスヘッダー」をご参照ください。
レスポンス要素
| 要素名 | タイプ | 説明 |
|---|---|---|
| WormConfiguration | コンテナー | ルートノード。
子ノード: WormId、State、RetentionPeriodInDays、およびCreationDate |
| WormId | String | 保持ポリシーのID。 |
| 状態 | String | 保持ポリシーのステータス。
設定可能な値は以下のとおりです。
|
| RetentionPeriodInDays | 正の整数 | オブジェクトを保持できる日数。 |
| CreationDate | String | 保持ポリシーが作成された時刻。 |
例
- リクエストの例
GET /? ワームHTTP/1.1 日付: 10月16日金曜日2020 11:18:32 GMT ホスト: BucketName.oss.aliyuncs.com 権限付与: SignatureValue - レスポンスの例
HTTP/1.1 200 OK x-oss-request-id: 5374A2880232A65C2300 **** 日付: 10月16日金曜日2020 11:18:32 GMT Content-Type: application/xml コンテンツ-長さ: 長さ <WormConfiguration> <WormId>1666E2CFB2B3418 ****</WormId> <State> ロック </State> <RetentionPeriodInDays>1</RetentionPeriodInDays> <CreationDate>2020-10-15T15:50:32</CreationDate> </WormConfiguration>