Amazon Simple Storage Service
API Reference (API Version 2006-03-01)

PUT Object legal hold

Applies a Legal Hold configuration to the specified object.

Request Syntax

PUT /<object-key>?legal-hold&versionId=<version-id> HTTP/1.1 Host: <bucket-name> Date: <Thu, 15 Nov 2016 00:17:21 GMT> Authorization: <authorization-string> (see Authenticating Requests (AWS Signature Version 4))

URI Request Parameters


The version ID of the object version that you want to put a retention period on.

Request Body

For more information about the request elements that this operation uses, see ObjectLockLegalHold.

Example Request Body:

<LegalHold> <Status>ON</Status> </LegalHold>

Response Syntax

HTTP/1.1 200

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

Related Resources

Locking Objects in the Amazon Simple Storage Service Developer Guide.