Listing items a few at a time examples

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>

Trademarks and Legal Disclaimer

© 2017 Hitachi Data Systems Corporation. All rights reserved.