List Parts

For a specific multipart upload, the List Parts operation lists the parts that have been uploaded. In the request, use the upload ID from the Create Multipart Upload operation. The default and maximum number of uploaded parts is 1000. To restrict the number of parts returned, use the max-parts request parameter, with a value from 1 to 1000. If the number of uploaded parts exceeds the list's limit, response field IsTruncated is set to true, and the response includes element NextPartNumberMarker, which can be used in a subsequent List Parts request.

Syntax Example

Request syntax example for List Parts:

GET https://appliance:443/s3/v1/export/share_mount_point_path/bucket_name/object_name?max-parts=MaxParts&part-number-marker=PartNumberMarker&uploadId=UploadId

Request Parameters

This implementation of the List Parts operation supports the following request parameters, as described in List Parts:

• max-parts - default value is 1000; error is returned if value is not between 1 to 1000

• part-number-marker - error is returned if part not found

• uploadId

Request Headers

This implementation of the List Parts operation supports the following request header, as described in Supported Common Request Headers: x-amz-expected-bucket-owner.

Request Elements

This implementation of the List Parts operation does not support the use of request elements.

Response Headers

This implementation of the List Parts operation supports response headers that are common to all operations, as described in table "Common Supported Response Headers" in Supported Common Response Headers.

Response Elements

This implementation of the List Parts operation returns the following response elements, as described in List Parts:

• Bucket

• Initiator

• IsTruncated

• Key

• ListPartsResult

• MaxParts

• NextPartNumberMarker

• Owner

• Part

• PartNumberMarker

• StorageClass

• UploadId

Expected HTTP Response Code

200 OK

Error Response Code

The List Parts operation does not return special errors. For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.

Example

GET example-object?max-parts=1&part-number-marker=1&uploadId=a7846887-2ad7-48d0-8547-d81549a24853 HTTP/1.1
x-amz-date: Thu, 12 Apr 2023 20:04:21 GMT
Authorization: authorization string

HTTP/1.1 200 OK
x-amz-request-id:txb71706d7a30f432cbe99d-0064488d79
Date: Thu, 12 Apr 2023 20:05:21 GMT
Content-Length: 693
<ListPartsResult>
  <Bucket>example-bucket</Bucket>
  <Key>example-object</Key>
  <UploadId>a7846887-2ad7-48d0-8547-d81549a24853</UploadId>
  <Initiator>
    <ID>user_tester</ID>
    <DisplayName>user_tester</DisplayName>
  </Initiator>
  <Owner>
    <ID>user_tester</ID>
    <DisplayName>user_tester</DisplayName>
  </Owner>
  <StorageClass>STANDARD</StorageClass>
  <PartNumberMarker>1</PartNumberMarker>
  <NextPartNumberMarker>2</NextPartNumberMarker>
  <MaxParts>1</MaxParts>
  <IsTruncated>false</IsTruncated>
  <Part>
    <PartNumber>2</PartNumber>
    <LastModified>2023-04-12T20:05:21.000Z</LastModified>
    <ETag>"cc9472149704128a4a7e3f90f828e394"</ETag>
    <Size>168</Size>
  </Part>
</ListPartsResult>