NetBackup™ Deduplication Guide

ListObjectVersions

Returns metadata about all versions of the objects in a bucket. You can also use request parameters as selection criteria to return metadata about a subset of all the object versions. S3 interface for MSDP recommends using this API with 1000 max keys and object name as a prefix to list all object versions in one request.

Request Syntax

GET /bucket/?versions&delimiter=Delimiter&key-marker=
KeyMarker&max-keys=MaxKeys&prefix=Prefix HTTP/1.1 
Host: msdps3.server:8443

Or

GET /bucket/?versions&delimiter=Delimiter&max-keys=
MaxKeys&prefix=Prefix&version-id-marker=VersionIdMarker HTTP/1.1 
Host: msdps3.server:8443

Request Parameters

Response Syntax

HTTP/1.1 200 
<?xml version="1.0" encoding="UTF-8"?>
<ListVersionsResult>>
    <IsTruncated>boolean</IsTruncated>
    <KeyMarker>string</KeyMarker>
    <VersionIdMarker>string</VersionIdMarker>
    <NextKeyMarker>string</NextKeyMarker>
    <NextVersionIdMarker>string</NextVersionIdMarker>
    <Version>
        <ETag>string</ETag>
        <IsLatest>boolean</IsLatest>
        <Key>string</Key>
        <LastModified>timestamp</LastModified>
        <Size>integer</Size>
        <StorageClass>string</StorageClass>
        <VersionId>string</VersionId>
    </Version>
    ...
    <DeleteMarker>
        <IsLatest>boolean</IsLatest>
        <Key>string</Key>
        <LastModified>timestamp</LastModified>
        <VersionId>string</VersionId>
    </DeleteMarker>
    ...
    <Name>string</Name>
    <Prefix>string</Prefix>
    <Delimiter>string</Delimiter>
    <MaxKeys>integer</MaxKeys>
    <CommonPrefixes>
        <Prefix>string</Prefix>
    </CommonPrefixes>
    ...
</ListVersionsResult>>

Response Body

Recommend less than 1000 CommonPrefixes elements under a specified prefix that is separated by the slash (/) delimiter character. If more than 10000 CommonPrefixes elements under a specified prefix exist, list objects with the prefix and the delimiter parameters in the request returns only 10000 elements. You can use list objects without delimiter if you want to list all elements under a specified prefix.

Possible Error Response