HCP Tenant Management Help


Example 2: Listing items a few at a time

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, 10 May 2019 17:19:26 +0000
Authorization: AWS bGdyZWVu:sf4WfS+TzOj9zrHVRA5Z0i1KsFg=
x-hcp-pretty-print: true

Response headers

HTTP/1.1 200 OK
Date: Fri, 10 May 2019 17:19:26 GMT
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>2018-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-2019</Key>
          <VersionId>87288779576769</VersionId>
          <IsLatest>true</IsLatest>
          <LastModified>2018-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>2019-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: Thu, 23 Feb 2017 17:20:01 +0000
Authorization: AWS bGdyZWVu:eYSJshWGcAf7i51jbpl/ZQqqJYM=
x-hcp-pretty-print: true

Response headers

HTTP/1.1 200 OK
Date: Thu, 23 Feb 2017 17:20:01 GMT
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>2019-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>2018-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>2018-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>

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.