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

PUT Object Tagging

The PUT Object Tagging operation adds a set of tags to an existing object. A tag is a key-value pair. You can associate tags with an object by sending a PUT request against the tagging subresource associated with the object. You can retrieve tags by sending a GET request. For more details, see the following:

• Syntax Example

• Request Parameters

• Request Headers

• Request Elements

• Response Headers

• Response Elements

• Expected HTTP Response Code

• Error Response Code

Syntax Example

For syntax examples of the PUT Object Tagging operation, see Amazon's official S3 API documentation (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUTtagging.html).

Request Parameters

This implementation of the PUT Object Tagging operation does not support the use of request parameters.

Request Headers

This implementation of the PUT Object Tagging operation does not support the use of request headers.

Request Elements

For a list of supported request elements, see Amazon's official S3 API PUT Object Tagging documentation (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUTtagging.html).

Response Headers

The PUT 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

This implementation of the PUT Object Tagging operation does not return response elements.

Expected HTTP Response Code

200 OK

Error Response Code

MalformedXMLError – The XML provided does not match the schema..

Example

PUT object-key?tagging HTTP/1.1
Content-Length: length
Content-MD5: pUNXr/BjKK5G2UKExample==
x-amz-date: 20180923T001956Z
Authorization: authorization string
<Tagging>
   <TagSet>
      <Tag>
         <Key>tag1</Key>
         <Value>val1</Value>
      </Tag>
      <Tag>
         <Key>tag2</Key>
         <Value>val2</Value>
      </Tag>
   </TagSet>
</Tagging>
HTTP/1.1 200 OK
x-amz-request-id: tx236A8905248E5A01
Date: Fri, 23 Sep 2018 00:20:19 GMT