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

GET Bucket Versioning

The GET Bucket Versioning operation returns the versioning state of a bucket. To retrieve the versioning state of a bucket, you must be the bucket owner. The following versioning states apply to this operation:

• When versioning is enabled on a bucket, the response is as follows:

  <VersioningConfiguration> <Status>Enabled</Status> </VersioningConfiguration>

• When versioning is suspended on a bucket, the response is as follows:

  <VersioningConfiguration> <Status>Suspended</Status> </VersioningConfiguration>

• When versioning is not enabled or suspended on a bucket, the response is as follows:

  <VersioningConfiguration/>

For further details about the using the GET Bucket Versioning operation, see the following:

• Syntax Example

• Request Parameters

• Request Headers

• Request Elements

• Response Headers

• Response Elements

• Normal Response Code

• Error Response Code

• Example

Syntax Example

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

Request Parameters

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

Request Headers

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

Response Headers

The GET Bucket Versioning operation uses only response headers that are common to most responses. For more information, see Figure 9, Table 9, Supported Response Headers .

Response Elements

The following XML response elements are supported:

• Status

• VersioningConfiguration

For a detailed description of these response elements, see Amazon's official S3 GET Bucket Versioning API documentation (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETversioningStatus.html).

Normal Response Code

200

Error Response Code

The GET Bucket Versioning operations does not support errors. For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.

Example

GET /?versioning
<VersioningConfiguration xmlns="http://s3.amazonaws.com/doc/2018-03-01/">
  <Status>Enabled</Status>
</VersioningConfiguration>