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

GET Service

Returns a list of all buckets owned by the authenticated sender of the request. Anonymous requests cannot list buckets, and you cannot list buckets that you did not create. For more details, see the following:

• Syntax Example

• Request Parameters

• Request Headers

• Response Elements

• Normal Response Code

Syntax Example

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

Request Parameters

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

Request Headers

The GET Service operation uses only request headers that are common to all operations. For more information, see Figure 7, Table 7, Common Supported Request Headers .

Response Elements

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

Normal Response Code

200

Example

<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult>
  <Owner>
    <ID>s3_user</ID>
    <DisplayName>s3_user</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <Name>quotes</Name>
      <CreationDate>2006-02-03T16:45:09.000Z</CreationDate>
    </Bucket>
    <Bucket>
      <Name>samples</Name>
      <CreationDate>2006-02-03T16:41:58.000Z</CreationDate>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>