GetObjectRetention を呼び出して、特定のオブジェクトバージョンの保持ポリシー（保持モードおよび保持期限日を含む）を取得します。
注意事項
この操作を呼び出す前に、PutBucketObjectWormConfiguration を呼び出してバケットに対してオブジェクトレベルの保持ポリシー（ObjectWorm）を有効にしておく必要があります。
この操作を呼び出すには、
oss:GetObjectRetention権限が必要です。オブジェクトに保持ポリシーが設定されておらず、かつバケットにもデフォルトのオブジェクトレベル保持ポリシーが設定されていない場合、返される Retention 要素内の Mode および RetainUntilDate は空になります。
リクエスト構文
GET /ObjectName?retention HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueリクエストパラメーター
パラメーター | タイプ | 必須 | 例 | 説明 |
retention | N/A | はい | N/A | オブジェクト保持ポリシーを取得する操作を指定します。 |
versionId | 文字列 | いいえ | CAEQNhiBgMDJgZCA0BYiIDc4MGZj**** | オブジェクトのバージョン ID です。省略した場合、最新バージョンのオブジェクトに対する保持ポリシーを取得します。 |
レスポンス要素
パラメーター | タイプ | 例 | 説明 |
Retention | コンテナ | N/A | オブジェクト保持ポリシー情報を格納するコンテナです。 子ノード：Mode および RetainUntilDate |
Mode | 文字列 | COMPLIANCE | オブジェクトの保持モードです。COMPLIANCE はコンプライアンスモードを示します。保持ポリシーが設定されていない場合は、このノードは空になります。 親ノード：Retention |
RetainUntilDate | 文字列 | 2026-10-11T00:00:00.000Z | オブジェクトバージョンの保持期限日です。日付は ISO 8601 フォーマットで表されます。この日付までは、オブジェクトバージョンを削除または上書きできません。保持ポリシーが設定されていない場合は、このノードは空になります。 親ノード：Retention |
使用例
リクエスト例
GET /exampleobject?retention&versionId=CAEQNhiBgMDJgZCA0BYiIDc4MGZj**** HTTP/1.1 Date: Thu, 17 Mar 2026 11:18:32 GMT Host: examplebucket.oss-cn-hangzhou.aliyuncs.com Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20260317/cn-hangzhou/oss/aliyun_v4_request,Signature=****レスポンス例
HTTP/1.1 200 OK x-oss-request-id: 5374A2880232A65C2300**** Date: Thu, 17 Mar 2026 11:18:32 GMT Content-Type: application/xml Transfer-Encoding: chunked Server: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <Retention> <Mode>COMPLIANCE</Mode> <RetainUntilDate>2026-10-11T00:00:00.000Z</RetainUntilDate> </Retention>