Tenant Cloud Storage Cloud Object Storage API References Querying Uploaded Parts

Querying Uploaded Parts

Last Updated At: 2025-10-21 09:10:00

Description

List Parts is used to query the uploaded parts in a specific multipart upload, that is, to list all successfully uploaded parts belonging to the specified UploadId.

Request

Request Example 

GET /<ObjectKey>?uploadId=UploadId HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: GMT Date
Authorization: Auth String

Note:

Authorization: Auth String (For details, see Request Signature.)

Request Header

Common Headers

This request uses common request headers. For details, see Common Request Headers.

Non-common Headers

This request has no special request header information.

Request Parameters

Name Type Required Description
UploadId string Yes The ID that identifies this multipart upload. When you use the Initiate Multipart Upload API to initialize multipart upload, you will get an uploadId, which not only uniquely identifies the multipart data, but also identifies the relative position of the multipart data in the entire file.
encoding-type string No Encoding method of the return value.
max-parts string No Maximum number of entries returned in a single response. The default value is 1,000.
part-number-marker string No By default, entries are listed in UTF-8 binary order, starting from the marker.

Request Body

The request does not have a request body.

Response

Response Headers

Common Response Headers

This response contains common response headers. For details, see Common Response Headers.

Special Response Headers

There are no special response headers for this response operation.

Response Body

The query is successful and returns application/xml data, including completed shard information.

<?xml version="1.0" encoding="UTF-8" ?>
<ListPartsResult>
    <Bucket>examplebucket-1250000000</Bucket>
    <Encoding-type/>
    <Key>exampleobject</Key>
    <UploadId>14846420620b1f381e5d7b057692e131dd8d72dfa28f2633cfbbe4d0a9e8bd0719933545b0</UploadId>
    <Initiator>
        <ID>1250000000</ID>
        <DisplyName>1250000000</DisplyName>
    </Initiator>
    <Owner>
        <ID>qcs::cam::uin/100000000001:uin/100000000001</ID>
        <DisplyName>100000000001</DisplyName>
    </Owner>
    <PartNumberMarker>0</PartNumberMarker>
    <Part>
        <PartNumber>1</PartNumber>
        <LastModified>Tue Jan 17 16:43:37 2017</LastModified>
        <ETag>"a1f8e5e4d63ac6970a0062a6277e191fe09a1382"</ETag>
        <Size>5242880</Size>
    </Part>
    <NextPartNumberMarker>1</NextPartNumberMarker>
    <StorageClass>STANDARD</StorageClass>
    <MaxParts>1</MaxParts>
    <IsTruncated>true</IsTruncated>
</ListPartsResult>

The data are described as follows:

Node Name (Keyword) Parent Node Description Type
ListPartsResult No Save all information from the List Parts request result. Container

Content of the Container node ListPartsResult:

Node Name (Keyword) Parent Node Description Type
Bucket ListPartsResult The target Bucket for multipart upload, the name of the bucket, consisting of a user-defined string and a system-generated APPID number connected by hyphens, for example: examplebucket-1250000000. string
Encoding-Type ListPartsResult Encoding Format string
Key ListPartsResult The name of the Object. string
UploadId ListPartsResult The ID that identifies this multipart upload string
Initiator ListPartsResult Used to indicate the information of the owners of these parts Container
Owner ListPartsResult Used to indicate the information of the owners of these parts Container
StorageClass ListPartsResult The storage class of these parts, with enumerated values: STANDARD, STANDARD_IA, ARCHIVE. string
PartNumberMarker ListPartsResult By default, entries are listed in UTF-8 binary order, starting from the marker. string
NextPartNumberMarker ListPartsResult If the returned entries are truncated, NextMarker is the starting point of the next entry. string
MaxParts ListPartsResult The maximum number of entries to return at a time string
IsTruncated ListPartsResult Indicates whether the returned list is truncated. Valid Boolean value: true, false. boolean
Part ListPartsResult Metadata Information Container

Contents of the Container node Initiator:

Node Name (Keyword) Parent Node Description Type
ID ListPartsResult.Initiator Creator's unique identifier string
DisplayName ListPartsResult.Initiator Description of the creator's username string

Content of Owner:

Node Name (Keyword) Parent Node Description Type
ID ListPartsResult.Owner Creator's unique identifier string
DisplayName ListPartsResult.Owner Description of the creator's username string

Container node Part content:

Node Name (Keyword) Parent Node Description Type
PartNumber ListPartsResult.Part Part number string
LastModified ListPartsResult.Part Description of when the block was last modified string
ETag ListPartsResult.Part Block's MD-5 algorithm checksum string
Size ListPartsResult.Part Description of block size, in bytes string

Practical Case

Request 

GET /exampleobject?uploadId=14846420620b1f381e5d7b057692e131dd8d72dfa28f2633cfbbe4d0a9e8bd0719933545b0&max-parts=1 HTTP/1.1
Host: examplebucket-1250000000.cos.city.yfm4.fsphere.cn
Date: Wed,18 Jan 2017 16:17:03 GMT
Authorization:q-sign-algorithm=sha1&q-ak=AKIDxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&q-sign-time=1484643123;1484646723&q-key-time=1484643123;1484646723&q-header-list=host&q-url-param-list=max-parts;uploadid&q-signature=b8b4055724e64c9ad848190a2f7625fd3f9d3e87

Response 

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 661
Connection: keep-alive
Date: Wed,18 Jan 2017 16:17:03 GMT
x-cos-request-id: NTg3ZGRiMzhfMmM4OGY3XzdhY2NfYw==

<ListPartsResult>
    <Bucket>examplebucket-1250000000</Bucket>
    <Encoding-type/>
    <Key>exampleobject</Key>
    <UploadId>14846420620b1f381e5d7b057692e131dd8d72dfa28f2633cfbbe4d0a9e8bd0719933545b0</UploadId>
    <Initiator>
        <ID>1250000000</ID>
        <DisplyName>1250000000</DisplyName>
    </Initiator>
    <Owner>
        <ID>qcs::cam::uin/100000000001:uin/100000000001</ID>
        <DisplyName>100000000001</DisplyName>
    </Owner>
    <PartNumberMarker>0</PartNumberMarker>
    <Part>
        <PartNumber>1</PartNumber>
        <LastModified>Tue Jan 17 16:43:37 2017</LastModified>
        <ETag>"a1f8e5e4d63ac6970a0062a6277e191fe09a1382"</ETag>
        <Size>5242880</Size>
    </Part>
    <NextPartNumberMarker>1</NextPartNumberMarker>
    <StorageClass>STANDARD</StorageClass>
    <MaxParts>1</MaxParts>
    <IsTruncated>true</IsTruncated>
</ListPartsResult>