Amazon Simple Storage Service
API Reference (API Version 2006-03-01)
AWS services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with AWS services in China.

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.