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

GET Bucket Tagging

The GET Bucket Tagging operation returns the tag set associated with the bucket. For more details about this operation, see the following:

• Syntax Example

• Request Parameters

• Request Headers

• Request Elements

• Response Headers

• Response Elements

• Normal Response Code

• Error Response Code

Syntax Example

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

Request Parameters

The GET Bucket Tagging operation does not support the use of request parameters.

Request Headers

The GET 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 GET Bucket Tagging operation does not support the use of request elements.

Response Headers

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

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

Normal Response Code

200

Error Response Code

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

Example

GET /?tagging
HTTP/1.1 200 OK
Date: Wed, 25 Nov 2018 12:00:00 GMT
Connection: close
Server: Apache

<Tagging>
  <TagSet>
     <Tag>
       <Key>Project</Key>
       <Value>Project One</Value>
     </Tag>
     <Tag>
       <Key>User</Key>
       <Value>msmith</Value>
     </Tag>
  </TagSet>
</Tagging>