Here are two sample GET requests for bucket listings that list item versions. The first request returns a list of three items. The second request returns a list of the three items that follow the last item returned by the first request.
Request for the first three items
The request for the first three items uses these query parameters:
•versions — Lists item versions
•key-marker=mktg/ — Starts the listing with the item that follows mktg/ by itself
•max-keys=3 — Lists at most three items
Request with s3curl command line
./s3curl.pl --id=lgreen -- -k "https://finance.europe.hcp.example.com?versions
&key-marker=mktg/&max-keys=3" -H "x-hcp-pretty-print:true"
Request headers
GET /?versions&key-marker=mktg/&max-keys=3 HTTP/1.1
Host: finance.europe.hcp.example.com
Date: Fri, 29 Mar 2013 17:15:55 +0000
Authorization: AWS bGdyZWVu:sf4WfS+TzOj9zrHVRA5Z0i1KsFg=
x-hcp-pretty-print: true
Response headers
HTTP/1.1 200 OK
Date: Fri, 29 Mar 2013 17:15:54 GMT
Server: HCP V7.0.0.16
Content-Type: application/xml;charset=UTF-8
Transfer-Encoding: chunked
Response body
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListVersionsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Name>finance</Name>
<Prefix></Prefix>
<KeyMarker>mktg/</KeyMarker><VersionIdMarker></VersionIdMarker>
<NextKeyMarker>mktg/campaign_GoGetEm_expenses.xls</NextKeyMarker>
<NextVersionIdMarker>87288784288321</NextVersionIdMarker>
<MaxKeys>3</MaxKeys>
<IsTruncated>true</IsTruncated>
<Version>
<Key>mktg/budget_proposals/</Key>
<VersionId>87288779571521</VersionId>
<IsLatest>true</IsLatest>
<LastModified>2012-11-13T17:12:00.805Z</LastModified>
<ETag>"d41d8cd98f00b204e9800998ecf8427e"</ETag>
<Size>0</Size>
<Owner>
<ID>b9d39144-a081-4762-b0e8-b8fb51e10192</ID>
<DisplayName>lgreen</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
</Version>
<Version>
<Key>mktg/budget_proposals/BudgProp-2013</Key>
<VersionId>87288779576769</VersionId>
<IsLatest>true</IsLatest>
<LastModified>2012-11-13T17:12:01.218Z</LastModified>
<ETag>"af65fc4d3e90617b3ad65a83a946be11"</ETag>
<Size>124591</Size>
<Owner>
<ID>b9d39144-a081-4762-b0e8-b8fb51e10192</ID>
<DisplayName>lgreen</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
</Version>
<Version>
<Key>mktg/campaign_GoGetEm_expenses.xls</Key>
<VersionId>87288784288321</VersionId>
<IsLatest>false</IsLatest>
<LastModified>2013-02-12T20:14:06.519Z</LastModified>
<ETag>"74d824cd5076a1361da128ee18e5a42b"</ETag>
<Size>92127</Size>
<Owner>
<ID>b9d39144-a081-4762-b0e8-b8fb51e10192</ID>
<DisplayName>lgreen</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
</Version>
</ListVersionsResult>
Request for next three items
The request for the next three items uses these query parameters:
•versions — Lists item versions.
•key-marker=mktg/campaign_GoGetEm_expenses.xls and version-id-marker=87288784288321 — Starts the listing with the item that follows version 87288784288321 of mktg/campaign_GoGetEm_expenses.xls. The version ID and item name are the values of the NextVersionIdMarker and NextKeyMarker elements from the previous response body, respectively.
•max-keys=3 — Lists at most three items.
Request with s3curl command line
./s3curl.pl --id=lgreen -- -k "https://finance.europe.hcp.example.com?versions
&key-marker=mktg/campaign_GoGetEm_expenses.xls
&version-id-marker=87288784288321&max-keys=3"
-H "x-hcp-pretty-print:true"
Request headers
GET /?versions&key-marker=mktg/campaign_GoGetEm_expenses.xls
&version-id-marker=87288784288321&max-keys=3 HTTP/1.1
Host: finance.europe.hcp.example.com
Date: Fri, 29 Mar 2013 18:03:33 +0000
Authorization: AWS bGdyZWVu:eYSJshWGcAf7i51jbpl/ZQqqJYM=
x-hcp-pretty-print: true
Response headers
HTTP/1.1 200 OK
Date: Fri, 29 Mar 2013 18:03:33 GMT
Server: HCP V7.0.0.16
Content-Type: application/xml;charset=UTF-8
Transfer-Encoding: chunked
Response body
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListVersionsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Name>finance</Name>
<Prefix></Prefix>
<KeyMarker>mktg/campaign_GoGetEm_expenses.xls</KeyMarker>
<VersionIdMarker>87288784288321</VersionIdMarker>
<NextKeyMarker>quarterly_rpts/</NextKeyMarker>
<NextVersionIdMarker>87288727467201</NextVersionIdMarker>
<MaxKeys>3</MaxKeys>
<IsTruncated>true</IsTruncated>
<Version>
<Key>mktg/campaign_GoGetEm_expenses.xls</Key>
<VersionId>87288825190337</VersionId>
<IsLatest>true</IsLatest>
<LastModified>2013-02-13T17:44:53.000Z</LastModified>
<ETag>"6ed7faad1e0661c03ad65a4317d4a94c"</ETag>
<Size>94328</Size>
<Owner>
<ID>b9d39144-a081-4762-b0e8-b8fb51e10192</ID>
<DisplayName>lgreen</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
</Version>
<Version>
<Key>mktg/campaign_LiveIt_expenses.xls</Key>
<VersionId>87288785222273</VersionId>
<IsLatest>true</IsLatest>
<LastModified>2012-11-5T14:32:29.110Z</LastModified>
<ETag>"7ad452af1e2f61b33a865c4362be5921"</ETag>
<Size>81578</Size>
<Owner>
<ID>b9d39144-a081-4762-b0e8-b8fb51e10192</ID>
<DisplayName>lgreen</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
</Version>
<Version>
<Key>quarterly_rpts/</Key>
<VersionId>87288727467201</VersionId>
<IsLatest>true</IsLatest>
<LastModified>2012-07-23T18:26:24.675Z</LastModified>
<ETag>"d41d8cd98f00b204e9800998ecf8427e"</ETag>
<Size>0</Size>
<Owner>
<ID>b9d39144-a081-4762-b0e8-b8fb51e10192</ID>
<DisplayName>lgreen</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
</Version>
</ListVersionsResult>
© 2017 Hitachi Data Systems Corporation. All rights reserved.