Example: Listing the parts of a multipart upload

Here's a sample GET request for a listing of the parts of an in-progress multipart upload for an object named acctg/RulesAndRegulations.pdf in the finance bucket. The request uses these query parameters in addition to uploadId:

part-number-marker=1 — Starts the list with the first part with a part number greater than one

max-parts=3 — Lists a maximum of three parts

The example assumes that parts one, two, three, five, and six have already been uploaded.

Request with s3curl command line

./s3curl.pl --id=lgreen -- -k
     "https://finance.europe.hcp.example.com/acctg/RulesAndRegulations.pdf
             ?uploadId=94837746087105&part-number-marker=1&max-parts=3"
     -H "x-hcp-pretty-print: true"

Request headers

GET /acctg/RulesAndRegulations.pdf?uploadId=94837746087105
     &part-number-marker=1&max-parts=3 HTTP/1.1
Host: finance.europe.hcp.example.com
Date: Fri, 07 February 2020 17:19:26 +0000
Authorization: AWS bGdyZWVu:Ey256+39Nz19jRw7chPIOJwD8m4=
x-hcp-pretty-print: true

Response headers

HTTP/1.1 200 OK
Date: Fri, 07 February 2020 17:19:26 GMT
x-amz-abort-date: Sat, 25 Feb 2017 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"?>
<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
     <Bucket>finance</Bucket>
     <Key>acctg/RulesAndRegulations.pdf</Key>
     <UploadId>94837746087105</UploadId>
     <Initiator>
          <ID>835be4b1-8f84-407b-8084-b9329beadf9b</ID>
          <DisplayName>lgreen</DisplayName>
     </Initiator>
     <Owner>
          <ID>835be4b1-8f84-407b-8084-b9329beadf9b</ID>
          <DisplayName>lgreen</DisplayName>
     </Owner>
     <StorageClass>STANDARD</StorageClass>
     <PartNumberMarker>1</PartNumberMarker>
     <NextPartNumberMarker>5</NextPartNumberMarker>
     <MaxParts>3</MaxParts>
     <IsTruncated>true</IsTruncated>
     <Part>
          <PartNumber>2</PartNumber>
          <LastModified>2017-02-23T17:19:26.000Z</LastModified>
          <ETag>"97ede335e69d08bb3cfbbd974bae68e4"</ETag>
          <Size>6800000</Size>
     </Part>
     <Part>
          <PartNumber>3</PartNumber>
          <LastModified>2017-02-23T17:19:26.000Z</LastModified>
          <ETag>"a39ebe49948a821cab2c4d7d04f9b1c3"</ETag>
          <Size>6800000</Size>
     </Part>
     <Part>
          <PartNumber>5</PartNumber>
          <LastModified>2017-02-23T17:19:26.000Z</LastModified>
          <ETag>"bbe438b2a0376f08dc37867a82ea87e6"</ETag>
          <Size>6700000</Size>
     </Part>
</ListPartsResult>

© 2015, 2020 Hitachi Vantara LLC. All rights reserved.