S3 get object retention

The get object retention API retrieves an object retention configuration on an object.

Syntax 

GET /BUCKET/OBJECT?retention&versionId= HTTP/1.1

Example

GET /testbucket/testobject?retention&versionId= HTTP/1.1

The versionId subresource retrieves a particular version of the object.

Response Entities

Retention

Description

A container for the request.

Type

Container

Required

Yes

Mode

Description

Retention mode for the specified object. Valid values: GOVERNANCE/COMPLIANCE

Type

String

Required

Yes

RetainUntilDate

Description

Retention date. Format: 2020-01-05T00:00:00.000Z

Type

Timestamp

Required

Yes

Reference

  • For more information about this API call, see S3 API.