GET Object Legal Hold

Get an object’s current legal hold status.

Request Syntax

GET /<object-key>?legal-hold&versionId=<version-id> HTTP/1.1
Host: <bucket-name>.s3.example.com
Date: <Thu, 15 Nov 2016 00:17:21 GMT>
Authorization: <authorization-string>

URI Request Parameters

versionId

The version ID for the object version whose legal hold status you want to retrieve.

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<LegalHold>
   <Status>string</Status>
</LegalHold>

Response Elements

The service returns an HTTP 200 response on success.