Oracle^® ZFS Storage Appliance Object API Guide for Amazon S3 Service Support, Release OS8.8.0

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. For more details about this operation, see the following:

• Syntax Example

• Request Parameters

• Request Headers

• Request Elements

• Response Headers

• Response Elements

• Expected HTTP Response Code

• Error Response Code

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 Figure 7, Table 7, Common Supported 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 Figure 9, Table 9, Supported Response Headers .

Response Elements

For a list of supported elements in the XML response for the GET Object Tagging operation, see Amazon's official S3 GET Object Tagging API documentation (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGETtagging.html).

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>