ListParts - List uploaded parts by upload ID in OSS - Object Storage Service

Usage notes

Results are sorted in ascending order of part numbers.
Build your part list from locally recorded part numbers and ETags rather than from ListParts responses. Parts can be accidentally overwritten, and network transmission errors may cause data discrepancies. If parts are overwritten, delete the unnecessary parts before you call CompleteMultipartUpload. Without local records, you cannot identify the correct parts or verify data integrity.

Permissions

By default, an Alibaba Cloud account has full permissions. RAM users or RAM roles under an Alibaba Cloud account do not have any permissions by default. The Alibaba Cloud account or account administrator must grant operation permissions through RAM policies or Bucket Policy.

Request syntax

Get  /ObjectName?uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature

Request headers

All headers in a ListParts request are common request headers. For more information, see Common request headers.

Request parameters

Parameter	Type	Example	Description
uploadId	String	0004B999EF5A239BB9138C6227D6****	The ID of the multipart upload task. Default: empty.
max-parts	Integer	1000	The maximum number of parts to return. Default value: 1000. Maximum value: 1000.
part-number-marker	Integer	100	Lists parts with part numbers greater than this value. Default: empty.
encoding-type	String	url	The encoding type of the object name in the response. XML 1.0 cannot parse certain control characters, such as those with ASCII values from 0 to 10. Set this parameter to encode object names that contain such characters. Default: empty. Valid value: url.

Response headers

All headers in the response to a ListParts request are common response headers. For more information, see Common response headers.

Response elements

Element	Type	Example	Description
ListPartsResult	Container	N/A	The root container for the ListParts response. Child nodes: Bucket, Key, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, and Part Parent nodes: none
Bucket	String	multipart_upload	The name of the bucket. Parent nodes: ListPartsResult
EncodingType	String	url	The encoding type of the object name. Returned when encoding-type is specified in the request. Parent nodes: ListPartsResult
Key	String	multipart.data	The name of the object. Parent nodes: ListPartsResult
UploadId	String	0004B999EF5A239BB9138C6227D69F95	The ID of the upload task. Parent nodes: ListPartsResult
PartNumberMarker	Integer	10	The part number marker specified in the request. Parts with numbers greater than this value are listed. Parent nodes: ListPartsResult
NextPartNumberMarker	Integer	5	The marker to use as part-number-marker in the next request when results are truncated. Parent nodes: ListPartsResult
MaxParts	Integer	1000	The maximum number of parts in the response. Parent nodes: ListPartsResult
IsTruncated	Enumerated string	false	Indicates whether the response is truncated. true: more parts are available. false: all parts are returned. Valid values: true and false. Parent nodes: ListPartsResult
Part	Container	N/A	The container for part details. Child nodes: PartNumber, LastModified, ETag, and Size Parent nodes: ListPartsResult
PartNumber	Integer	1	The part number. Parent nodes: ListPartsResult.Part
LastModified	Date	2012-02-23T07:01:34.000Z	The time when the part was uploaded. Parent nodes: ListPartsResult.Part
ETag	String	3349DC700140D7F86A0784842780****	The ETag of the uploaded part. Parent nodes: ListPartsResult.Part
Size	Integer	6291456	The size of the uploaded part. Parent nodes: ListPartsResult.Part

Examples

Sample request

Get  /multipart.data?uploadId=0004B999EF5A239BB9138C6227D6****  HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 07:13:28 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Sample success response

HTTP/1.1 200 
Server: AliyunOSS
Connection: keep-alive
Content-length: 1221
Content-type: application/xml
x-oss-request-id: 106452c8-10ff-812d-736e-c865294afc1c
Date: Thu, 23 Feb 2012 07:13:28 GMT

<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
    <Bucket>multipart_upload</Bucket>
    <Key>multipart.data</Key>
    <UploadId>0004B999EF5A239BB9138C6227D6****</UploadId>
    <NextPartNumberMarker>5</NextPartNumberMarker>
    <MaxParts>1000</MaxParts>
    <IsTruncated>false</IsTruncated>
    <Part>
        <PartNumber>1</PartNumber>
        <LastModified>2012-02-23T07:01:34.000Z</LastModified>
        <ETag>"3349DC700140D7F86A0784842780****"</ETag>
        <Size>6291456</Size>
    </Part>
    <Part>
        <PartNumber>2</PartNumber>
        <LastModified>2012-02-23T07:01:12.000Z</LastModified>
        <ETag>"3349DC700140D7F86A0784842780****"</ETag>
        <Size>6291456</Size>
    </Part>
    <Part>
        <PartNumber>5</PartNumber>
        <LastModified>2012-02-23T07:02:03.000Z</LastModified>
        <ETag>"7265F4D211B56873A381D321F586****"</ETag>
        <Size>1024</Size>
    </Part>
</ListPartsResult>

OSS SDKs

Call ListParts with the following OSS SDKs:

ossutil

For information about the ossutil command that corresponds to the ListParts operation, see list-parts.

API	Action	Description
ListParts	`oss:ListParts`	Lists all parts that are uploaded by using an upload ID.