Lists all parts that are uploaded by using a specified upload ID.
Usage notes
- The results returned by Object Storage Service (OSS) are listed in ascending order of part numbers.
- Errors may occur during network transmission. Therefore, to generate the list of uploaded parts, we recommend that you do not use the part numbers and ETag values in the results of the ListParts operation.
Request syntax
Get /ObjectName?uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature
Request headers
This request contains only common request headers. For more information, see Common request headers.
Request parameters
Parameter | Type | Example | Description |
---|---|---|---|
uploadId | String | 0004B999EF5A239BB9138C6227D69F95 | The ID of the multipart upload task.
Default value: null |
max-parts | Integer | 1000 | The maximum number of parts that can be returned by OSS.
Default value: 1000 Maximum value: 1000 |
part-number-marker | Integer | 100 | The position from which the list starts. All parts whose part numbers are greater
than the value of this parameter are listed.
Default value: null |
encoding-type | String | url | The encoding type of the object name in the response. The object name can contain
any characters encoded in UTF-8. However, the XML 1.0 standard cannot be used to parse
certain control characters, such as characters with an ASCII value from 0 to 10. You
can specify the Encoding-type parameter to encode the returned object name.
Default value: null Valid value: url |
Response headers
The response to this request contains only common response headers. For more information, see Common response headers.
Response elements
Element | Type | Example | Description |
---|---|---|---|
ListPartsResult | Container | N/A | The container that stores the response of the ListParts request.
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 in the response. If the Encoding-type parameter
is specified in the request, the object name in the response is encoded.
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 position from which the list starts. All parts whose part numbers are greater
than the value of this parameter are listed.
Parent nodes: ListPartsResult |
NextPartNumberMarker | Integer | 5 | The NextPartNumberMarker value that is used for the PartNumberMarker value in a subsequent
request when the response does not contain all required results.
Parent nodes: ListPartsResult |
MaxParts | Integer | 1000 | The maximum number of parts in the response.
Parent nodes: ListPartsResult |
IsTruncated | Enumerated string | false | Indicates whether the list of parts returned in the response has been truncated. A
value of true indicates that the response does not contain all required results. A
value of false indicates that the response contains all required results.
Valid values: true and false Parent nodes: ListPartsResult |
Part | Container | N/A | The container that stores the information about parts.
Child nodes: PartNumber, LastModified, ETag, and Size Parent nodes: ListPartsResult |
PartNumber | Integer | 1 | The number that identifies a part.
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 value of the content of the uploaded part.
Parent nodes: ListPartsResult.Part |
Size | Integer | 6291456 | The size of the uploaded parts.
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: OSS qn6qrrqxo2oawuk53otf****:4qOnUMc9UQWqkz8wDqD3lIsa****
Sample 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>
SDKs
You can use OSS SDKs for the following programming languages to call the ListParts operation: