ListObjectVersions

Tebi does not support object versions. This API call is implemented only for S3 protocol compatibility and will return a regular objects list.

You must have List ACL to be able to call this action.

The following operations are related to ListObjectVersions:

Request Syntax

1GET /?versions&delimiter=Delimiter&marker=Marker&max-keys=MaxKeys&prefix=Prefix&version-id-marker=VersionIdMarker HTTP/1.1
2Host: <BUCKET>.s3.tebi.io

The request uses the following URI parameters:

  • <BUCKET>: Name of the bucket containing the objects. Required.

  • delimiter: Character used to group keys. Only forward slash / is supported by Tebi as a delimiter.

  • marker: Specifies the key to start with when listing objects in a bucket.

  • max-keys: Sets the maximum number of keys returned in the response. By default, the action returns up to 1,000 key names. The response might contain fewer keys, but will never contain more.

  • prefix: Limits the response to keys that begin with the specified prefix.

  • version-id-marker: Specifies the object version you want to start listing from.

The request does not have a request body.

Response Syntax

 1HTTP/1.1 200
 2Content-Type: application/xml
 3Content-Length: ContentLength
 4
 5<?xml version="1.0" encoding="UTF-8"?>
 6<ListVersionsResult>
 7    <IsTruncated>boolean</IsTruncated>
 8    <VersionIdMarker>string</VersionIdMarker>
 9    <NextVersionIdMarker>string</NextVersionIdMarker>
10    <Version>
11        <ETag>string</ETag>
12        <IsLatest>boolean</IsLatest>
13        <Key>string</Key>
14        <LastModified>timestamp</LastModified>
15        <Owner>
16            <DisplayName>string</DisplayName>
17            <ID>string</ID>
18        </Owner>
19        <Size>integer</Size>
20        <StorageClass>string</StorageClass>
21        <VersionId>string</VersionId>
22    </Version>
23    ...
24    <Name>string</Name>
25    <Prefix>string</Prefix>
26    <Delimiter>string</Delimiter>
27    <MaxKeys>integer</MaxKeys>
28    <CommonPrefixes>
29        <Prefix>string</Prefix>
30    </CommonPrefixes>
31    ...
32</ListVersionsResult>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in XML format by the service:

  • ListVersionsResult: Root level tag for the ListVersionsResult parameters.

  • CommonPrefixes: All keys rolled up into a common prefix count as a single return when calculating the number of returns.

  • Delimiter: Causes keys that contain the same string between the prefix and the first occurrence of the delimiter to be rolled up into a single result element in the CommonPrefixes collection. These rolled-up keys are not returned elsewhere in the response. Each rolled-up result counts as only one return against the MaxKeys value. Only forward slash / is supported by Tebi as a delimiter.

  • IsTruncated: Flag that indicates whether Tebi returned all of the results that satisfied the search criteria.

  • MaxKeys: Specifies the maximum number of objects to return.

  • Name: Bucket name.

  • NextVersionIdMarker: When the number of responses exceeds the value of MaxKeys, NextVersionIdMarker specifies the first object version not returned that satisfies the search criteria. Use this value for the version-id-marker request parameter in a subsequent request.

  • Prefix: Selects objects that start with the value supplied by this parameter.

  • Version: Container for version information. It is always null.

  • VersionIdMarker: Marks the last version of the key returned in a truncated response.

See Also

Refer here for more information.