Back
Object Storage
CDNetworks Documentation Object Storage API ListParts

ListParts

Last update：2025-08-18 15:54:07

Users can list parts of a multipartupload task by calling this interface.

At most 1000 parts can be listed in a response and you can set this number with parameter max-parts(default at 1000). If there are over 1000 parts of a multipartupload task, IsTruncated and NextPartNumberMarker will be returned in response(IsTruncated is True this way). And you can get the following parts by setting parameter part-number-marker at the value of NextPartNumberMarker in next ListParts request.

Request syntax

GET /ObjectName?uploadId=uploadid&max-parts=max&part-number-marker=marker HTTP/1
Host: Bucket.Endpoint
Date: date
Authorization: authorization

URI request parameters

Name Description Required
uploadId The upload ID which identify the upload task.
Type: String
Default value: None		 Yes
max-parts The maximum number of parts you can list in one request.
Type: String
Default value: 1000		 No
part-number-marker Specifies the start position of the List. Only Parts with a Part Number greater than this parameter will be listed.
Type: String
For example: if the value is set to 250, it means the listing will start from the 251st part.		 No

Request header

Please use Common request headers .

Request body

None

Response syntax

HTTP/1.1 status_code

x-wos-request-id: request id
Date: date
Content-Length: length
Connection: state
Server:WS-web-server
<?xml version="1.0" encoding="UTF-8" standalone="yes"?
<ListPartsResult xmlns=" https://www.wangsu.com/document">
  <Bucket>BucketName</Bucket>
  <Key>object</Key>
  <UploadId>uploadid</UploadId>
  <Initiator>
    <ID>initiatorid</ID>
    <DisplayName>displayname</DisplayName>
  </Initiator>
  <Owner>
    <ID>ownerid</ID>
    <DisplayName>ownername</DisplayName>
  </Owner>
  <PartNumberMarker>partNmebermarker</PartNumberMarker>
  <NextPartNumberMarker>nextpartnumbermarker</NextPartNumberMarker>
  <MaxParts>2</MaxParts>
  <IsTruncated>true</IsTruncated>
  <Part>
    <PartNumber>partnumber1</PartNumber>
    <LastModified>modifieddate</LastModified>
    <ETag>etag</ETag>
    <Size>size</Size>
  </Part>
  <Part>
    <PartNumber>partnumber2</PartNumber>
    <LastModified>modifieddate</LastModified>
    <ETag>etag</ETag>
    <Size>size</Size>
  </Part>
  ...
</ListPartsResult>

Response header

Please use Common response headers .

Response body

Name Description
ListPartsResult Container for the results of a List Part request.
Type: XML namespace
Child nodes: Bucket, Key, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, Part.
Parent node: None
Bucket Bucket Name.
Type: String
Parent node: ListPartsResult
Key Object Name.
Type: String
Parent node: ListPartsResult
UploadId ID of the upload task.
Type: string
Parent node: ListPartsResult
Initiator Creator of the Upload task.
Type: XML namespace
Child nodes: ID, DisplayName
Parent node: ListPartsResult
ID Creator’s DomainID.
Type: String
Parent nodes: Initiator, Owner
DisplayName Creator’s name.
Type: String
Parent nodes: Initiator , Owner
PartNumberMarker Start position of the list for this request.
Type: Integer
Parent node: ListPartsResult
NextPartNumberMarker If not all results are returned in this request, NextPartNumberMarker is in the response, which indicating the start position of the list in next request.
Type: Integer
Parent Node: ListPartsResult
MaxParts Biggest number of parts listed in one request. The range is [ 1,1000].
Type: Integer
Parent Node: ListPartsResult
IsTruncated IsTruncated indicates whether the list of parts is truncated or not. “true” means that not all parts are listed in this request; “false” means all parts have been returned.
Type: Boolean
Parent Node: ListPartsResult
Part Container for part information.
Type: XML namespace
Child nodes: PartNumber, LastModified, ETag, Size.
Parent node: ListPartsResult
PartNumber The number of an uploaded part.
Type: Integer
Parent node: ListPartsResult
LastModified Time when the part is uploaded.
Type: Date
Parent node: ListPartsResult
ETag The ETag of an uploaded part .
Type: String.
Parent node: ListPartsResult
Size Size of an uploaded part.
Type: Integer.
Parent node: ListPartsResult

Special error

Situation HTTP Status Error Code Message
The specified uploadId does not exist. This may be because the upload ID is invalid, or the corresponding multipart upload has already been completed or aborted. 404 Not Found NoSuchUpload The specified upload does not exist. The upload ID may be invalid, or the upload may have been aborted or completed.
The specified uploadId does not match the specified object. 404 Not Found NoSuchUpload The specified upload does not exist. The upload ID may be invalid, or the upload may have been aborted or completed.
The value of max-parts is either negative or greater than 1000. 400 Bad Request InvalidArgument Argument maxParts must be an integer between 0 and 1000.
The value of max-parts is not a number. 400 Bad Request InvalidArgument Provided maxParts is not an integer or is out of the integer range.
The value of part-number-marker is not a number. 400 Bad Request InvalidArgument Provided part-number-marker is not an integer.

Example

GET /example-object?uploadId=XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA&max-parts=2&part-number-marker=1 HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: WOS AKIAIOSFODNN7EXAMPLE:0RQf4/cRonhpaBX5sCYVf1bNRuU=


HTTP/1.1 200 OK
x-wos-request-id: 656c76696e6727732072657175657374
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 985
Connection: keep-alive

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListPartsResult xmlns=" https://www.wangsu.com/document">
  <Bucket>example-bucket</Bucket>
  <Key>example-object</Key>
  <UploadId>XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA</UploadId>
  <Initiator>
    <ID> 11116a31-17b5-4fb7-9df5-b288870f11xx</ID>
    <DisplayName>umat-user-11116a31-17b5-4fb7-9df5-b288870f11xx</DisplayName>
  </Initiator>
  <PartNumberMarker>1</PartNumberMarker>
  <NextPartNumberMarker>3</NextPartNumberMarker>
  <MaxParts>2</MaxParts>

  <IsTruncated>true</IsTruncated>
  <Part>
    <PartNumber>1</PartNumber>
    <LastModified>2020-11-10T20:48:000Z</LastModified>
    <ETag>"5678aef83f66abc1fa1e8477fsfsda6d394"</ETag>
    <Size>10485760</Size>
  </Part>
  <Part>
    <PartNumber>2</PartNumber>
    <LastModified>2020-11-10T20:49:000Z</LastModified>
    <ETag>"7778aef83f66abc1fa1e8477f296d394"</ETag>
    <Size>10485760</Size>
  </Part>
  <Part>
    <PartNumber>3</PartNumber>
    <LastModified>2020-11-10T20:50:000Z</LastModified>
    <ETag>"aaaa18db4cc2f85cedef654fccc4a4x8"</ETag>
    <Size>10485760</Size>
  </Part>
</ListPartsResult>
Is the content of this document helpful to you?
Yes
I have suggestion
Submitted successfully! Thank you very much for your feedback, we will continue to strive to do better!

CDNetworks Inc., © 2025. 1840 Enterprise Way, Monrovia, CA 91016 – All rights reserved.