この操作では、指定されたバケットに設定された保持ポリシーを照会します。
リクエストの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 /? worm HTTP/1.1 Date: Fri, 16 Oct 2020 11:18:32 GMT Host: BucketName.oss.aliyuncs.com Authorization: SignatureValueレスポンスの例
HTTP/1.1 200 OK x-oss-request-id: 5374A2880232A65C2300**** Date: Fri, 16 Oct 2020 11:18:32 GMT Content-Type: application/xml Content-Length: length <WormConfiguration> <WormId>1666E2CFB2B3418****</WormId> <State>Locked</State> <RetentionPeriodInDays>1</RetentionPeriodInDays> <CreationDate>2020-10-15T15:50:32</CreationDate> </WormConfiguration>
SDK
次のプログラミング言語のOSS SDKを使用して、GetBucketWormを呼び出すことができます。