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.

Syntax Example

GET https://appliance:443/s3/v1/export/share_mount_point_path/bucketname?versions

Request Parameters

For a list of supported request parameters, see GET Bucket Object versions.

Request Headers

The GET Bucket Object Versioning operation uses only request headers that are common to all operations. For more information, see table "Common Supported Request Headers" in Supported Common 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, see table "Supported Response Headers" in Supported Common Response Headers.

Response Elements

For a list of supported response elements, see GET Bucket Object versions.

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

Note:

For additional request and response examples, see GET Bucket Object versions.

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>