Get Object Retention (Flex WORM only)
Retrieves an object's retention settings.
Request Syntax
GET /{bucket}/Key+?retention&versionId=VersionId HTTP/1.1 Host: msdps3.server:8443
Request Parameters
Bucket
The bucket name that contains the object for which you want to retrieve the retention settings.
Required: Yes
Type: String
Key
The key name for the object for which you want to retrieve the retention settings.
Required: Yes
Type: String
versionId
The version ID for the object for which you want to retrieve the retention settings.
Type: String
Response Syntax
HTTP/1.1 200 <?xml version="1.0" encoding="UTF-8"?> <Retention> <Mode>string</Mode> <RetainUntilDate>timestamp</RetainUntilDate> </Retention>
Response Body
Retention
Root level tag for the Retention parameters.
Required: Yes
Mode
Indicates the Retention mode for the specified object.
Valid Values: GOVERNANCE, COMPLIANCE
Type: String
RetainUntilDate
The date on which this Object Lock Retention expires.
Type: Timestamp
Possible Error Response
Success
HTTP status code 200.
InvalidArgument
Invalid Argument. Invalid version id specified.
HTTP status code 400.
AccessDenied
Request was rejected because user authentication failed.
HTTP status code 403.
NoSuchKey
The specified key does not exist.
HTTP status code 404.
NoSuchBucket
The specified bucket does not exist.
HTTP status code 404.