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

GET Bucket Object Versioning

The GET Bucket Object Versioning operation lists metadata about all of the object versions in a bucket. Additionally, you can use request parameters as selection criteria to return metadata about a subset of all the object versions. 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>?versions

Request Parameters

For a list of request parameters supported in a request query, see Amazon's official S3 GET Bucket Object Version API documentation (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETVersion.html).

Request Headers

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

Response Headers

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

Response Elements

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

Normal Response Code

200

Error Response Code

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

Example

GET /?versions
<?xml version="1.0" encoding="UTF-8"?>

<ListVersionsResult>
    <Name>bucket</Name>
    <Prefix>my</Prefix>
    <KeyMarker/>
    <VersionIdMarker/>
    <MaxKeys>5</MaxKeys>
    <IsTruncated>false</IsTruncated>
    <Version>
        <Key>my-image.jpg</Key>
        <VersionId>003</VersionId>
        <IsLatest>true</IsLatest>
         <LastModified>2018-10-12T17:50:30.000Z</LastModified>
        <ETag>&quot;fba9dede5f27731c9771645a39863328&quot;</ETag>
        <Size>434234</Size>
        <StorageClass>STANDARD</StorageClass>
        <Owner>
            <ID>mary</ID>
            <DisplayName>mary</DisplayName>
        </Owner>
    </Version>
    <DeleteMarker>
        <Key>my-second-image.jpg</Key>
        <VersionId>001</VersionId>
        <IsLatest>true</IsLatest>
        <LastModified>2009-11-12T17:50:30.000Z</LastModified>
        <Owner>
            <ID>jill</ID>
            <DisplayName>jill</DisplayName>
        </Owner>    
    </DeleteMarker>
    <Version>
        <Key>my-second-image.jpg</Key>
        <VersionId>002</VersionId>
        <IsLatest>false</IsLatest>
        <LastModified>2009-10-10T17:50:30.000Z</LastModified>
        <ETag>&quot;9b2cf535f27731c974343645a3985328&quot;</ETag>
        <Size>166434</Size>
        <StorageClass>STANDARD</StorageClass>
        <Owner>
            <ID>jill</ID>
            <DisplayName>jill</DisplayName>
        </Owner>
    </Version>
    <DeleteMarker>
        <Key>my-third-image.jpg</Key>
        <VersionId>002</VersionId>
        <IsLatest>true</IsLatest>
        <LastModified>2009-10-15T17:50:30.000Z</LastModified>
        <Owner>
            <ID>moe</ID>
            <DisplayName>moe</DisplayName>
        </Owner>    
    </DeleteMarker>   
    <Version>
        <Key>my-third-image.jpg</Key>
        <VersionId>001</VersionId>
        <IsLatest>false</IsLatest>
        <LastModified>2009-10-11T12:50:30.000Z</LastModified>
        <ETag>&quot;772cf535f27731c974343645a3985328&quot;</ETag>
        <Size>64</Size>
        <StorageClass>STANDARD</StorageClass>
        <Owner>
            <ID>moe</ID>
            <DisplayName>moe</DisplayName>
        </Owner>
     </Version>
</ListVersionsResult>