GET Object Tagging

The GET Object Tagging operation returns the tags associated with an object by sending the GET request against the tagging subresource associated with the object. To use this operation, you must have READ permissions on the object.

Syntax Example

GET https://appliance:443/s3/v1/export/share_mount_point_path/bucketname/objectname?tagging

Request Parameters

This implementation of GET Object Tagging API does not support the use of request parameters.

Request Headers

The GET Object Tagging operation uses only request headers that are common to all operations. For more information, see table "Common Supported Request Headers" in Supported Common Request Headers.

Request Elements

The GET Object Tagging operation does not support the use of request elements.

Response Headers

The GET Object Tagging operation uses only response headers that are common to most responses. For more information, see table "Supported Response Headers" in Supported Common Response Headers.

Response Elements

For a list of supported elements in the XML response for the GET Object Tagging operation, see GET Object tagging.

Expected HTTP Response Code

200 OK

Error Response Code

The GET Object Tagging operation does not return special errors. For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.

Example

GET /example-object?tagging
HTTP/1.1 200 OK
Date: Thu, 22 Sep 2018 21:33:08 GMT
Connection: close
Server: Apache
<?xml version="1.0" encoding="UTF-8"?>
<Tagging xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <TagSet>
      <Tag>
         <Key>tag1</Key>
         <Value>val1</Value>
      </Tag>
      <Tag>
         <Key>tag2</Key>
         <Value>val2</Value>
      </Tag>
   </TagSet>
</Tagging>