The Wayback Machine - https://web.archive.org/web/20190714140347/https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUTLegalHold.html
Sign In to the Console
Amazon Simple Storage Service
API Reference (API Version 2006-03-01)

AWS Documentation » Amazon Simple Storage Service (S3) » API Reference » Operations on Objects » PUT Object legal hold

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>.s3.amazonaws.com
Date: <Thu, 15 Nov 2016 00:17:21 GMT>
Authorization: <authorization-string> (see Authenticating Requests (AWS Signature Version
		4))

URI Request Parameters

versionId

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.