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

PUT Bucket Tagging

The PUT Bucket Tagging operation enables you to add a set of tags to an existing bucket. The bucket owner has this permission by default and can grant this permission to others. 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

PUT https://<appliance>:443/s3/v1/export/<share_mount_point_path>/<bucketname>?tagging

Request Parameters

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

Request Headers

The PUT Bucket 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 PUT Bucket Tagging operation supports the use of request elements. For description of these request elements, see Amazon's official PUT Bucket Tagging documentation (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTtagging.html ).

Response Headers

The PUT Bucket 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 Bucket Tagging operation does not return response elements.

Expected HTTP Response Code

204 No Content

Error Response Code

This implementation of the PUT Bucket Tagging operation supports the use of the following response errors

• Special Error – MalformedXMLError where the XML provided does not match the schema.

• Common Errors – For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.

Example

PUT ?tagging HTTP/1.1
Content-Length: 1660
x-amz-date: Thu, 12 Apr 2018 20:04:21 GMT
Authorization: authorization string

<Tagging>
  <TagSet>
    <Tag>
      <Key>Project</Key>
      <Value>Project One</Value>
    </Tag>
    <Tag>
      <Key>User</Key>
      <Value>jsmith</Value>
    </Tag>
  </TagSet>
</Tagging>
HTTP/1.1 204 No Content