GET Object Retention¶

Retrieves an object’s retention settings.

Request Syntax¶

GET /<object-key>?retention&versionId=<version-id> HTTP/1.1
Host: <bucket-name>.s3.example.com
Date: <Thu, 15 Nov 2016 00:17:21 GMT>
Authorization: <authorization-string>

URI Request Parameters¶

versionId

The version ID for the object whose retention settings you want to retrieve.

Request Body¶

There is no request body for this request.

Response Syntax¶

<Retention>
   <Mode><value></Mode>
   <RetainUntilDate><value></RetainUntilDate>
</Retention>

Response Elements¶

On success, the service returns an HTTP 200 response.