List Parts

Overview
This API is used to query the uploaded parts of a specified multipart upload, i.e., listing all successfully uploaded parts of a multipart upload whose uploadId is specified.
Note: 
Only the root account or sub-accounts granted the permission of the List Part API can call this API.
﻿
Requests
Request example
GET /<ObjectKey>?uploadId=UploadId HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
Note: 
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com, where <BucketName-APPID> is the bucket name followed by the APPID, such as examplebucket-1250000000 (see Bucket Overview > Basic Information and Bucket Overview > Bucket Naming Conventions), and <Region> is a COS region (see Regions and Access Endpoints).
Authorization: Auth String (See Request Signature for details.)
Request headers
This API only uses Common Request Headers.
Request fields
Parameter
Description
Type
Required
uploadId
Multipart upload ID obtained from the Initiate Multipart Upload API
string
Yes
encoding-type
Encoding type for the returned value
string
No
max-parts
Maximum number of entries to be returned at a time. Maximum value: 1000. Default value: 1000.
int
No
part-number-marker
By default, parts are listed in UTF-8 binary order, starting from the part after the marker.
string
No
Request body
The request body of this request is empty.
Response
Response headers
This API only returns Common Response Headers.
Response body
A successful query returns application/xml data, which includes information about the successfully uploaded parts.
<?xml version="1.0" encoding="UTF-8" ?>
<ListPartsResult>
    <Bucket>examplebucket-1250000000</Bucket>
    <Encoding-type/>
    <Key>exampleobject</Key>
    <UploadId>14846420620b1f381e5d7b057692e131dd8d72dfa28f2633cfbbe4d0a9e8bd0719933545b0</UploadId>
    <Initiator>
        <ID>1250000000</ID>
        <DisplayName>1250000000</DisplayName>
    </Initiator>
    <Owner>
        <ID>qcs::cam::uin/100000000001:uin/100000000001</ID>
        <DisplayName>100000000001</DisplayName>
    </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 nodes are described as follows:
Node Name (Keyword)
Parent Node
Description
Type
ListPartsResult
None
Stores the response of List Parts.
Container
Content of ListPartsResult:
Node Name (Keyword)
Parent Node
Description
Type
Bucket
ListPartsResult
Name of the destination bucket for the multipart upload. It is formed by connecting a user-defined string and the system-generated APPID with a hyphen, for example, examplebucket-1250000000.
string
Encoding-Type
ListPartsResult
Encoding type
string
Key
ListPartsResult
Object name
string
UploadId
ListPartsResult
ID of the multipart upload
string
Initiator
ListPartsResult
Information about the request initiator
Container
Owner
ListPartsResult
Information about the part owner
Container
StorageClass
ListPartsResult
Storage class of the parts. Enumerated values: STANDARD, STANDARD_IA, ARCHIVE, DEEP_ARCHIVE. For more information, please see Storage Class Overview.
string
PartNumberMarker
ListPartsResult
By default, parts are listed in UTF-8 binary order, starting from the part after the marker.
string
NextPartNumberMarker
ListPartsResult
If the returned list is truncated, the NextMarker returned will be the starting point of the subsequent list.
string
MaxParts
ListPartsResult
Maximum number of entries to be returned at a time
int
IsTruncated
ListPartsResult
Indicates whether the returned list is truncated. Valid values: true, false
boolean
Part
ListPartsResult
Metadata
Container
Content of Initiator:
Node Name (Keyword)
Parent Node
Description
Type
ID
ListPartsResult.Initiator
Unique ID of the initiator
string
DisplayName
ListPartsResult.Initiator
Username of the initiator
string
Content of Owner:
Node Name (Keyword)
Parent Node
Description
Type
ID
ListPartsResult.Owner
Unique ID of the owner
string
DisplayName
ListPartsResult.Owner
Username of the owner
string
Content of Part:
Node Name (Keyword)
Parent Node
Description
Type
PartNumber
ListPartsResult.Part
Part number
string
LastModified
ListPartsResult.Part
Last modified time of a part
string
ETag
ListPartsResult.Part
MD5 checksum of a part
string
Size
ListPartsResult.Part
Part size, in bytes
string
Error codes
This API returns common error responses and error codes. For more information, see Error Codes.
Examples
Request
GET /exampleobject?uploadId=1585130821cbb7df1d11846c073ad648e8f33b087cec2381df437acdc833cf654b9ecc6361 HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Wed, 25 Mar 2020 10:07:25 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1585130845;1585138045&q-key-time=1585130845;1585138045&q-header-list=date;host&q-url-param-list=uploadid&q-signature=ba8d97cefa396d804524a38d7b5412fb0261****
Connection: close
Response
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1119
Connection: close
Date: Wed, 25 Mar 2020 10:07:25 GMT
Server: tencent-cos
x-cos-request-id: NWU3YjJkNWRfMjNhZjJhMDlfNWY5Ml8zMmUy****
﻿
﻿
﻿
<ListPartsResult>
            <Bucket>examplebucket-1250000000</Bucket>
            <EncodingType/>
            <Key>exampleobject</Key>
            <UploadId>1585130821cbb7df1d11846c073ad648e8f33b087cec2381df437acdc833cf654b9ecc6361</UploadId>
            <Owner>
                <ID>1250000000</ID>
                <DisplayName>1250000000</DisplayName>
            </Owner>
            <PartNumberMarker>0</PartNumberMarker>
            <Initiator>
                <ID>qcs::cam::uin/100000000001:uin/100000000011</ID>
                <DisplayName>100000000011</DisplayName>
            </Initiator>
            <Part>
                <PartNumber>1</PartNumber>
                <LastModified>2020-03-25T10:07:14.000Z</LastModified>
                <ETag>&quot;39270a968a357d24207e9911162507eb&quot;</ETag>
                <Size>1048576</Size>
            </Part>
            <Part>
                <PartNumber>2</PartNumber>
                <LastModified>2020-03-25T10:07:13.000Z</LastModified>
                <ETag>&quot;d899fbd1e06109ea2e4550f5751c88d6&quot;</ETag>
                <Size>1048576</Size>
            </Part>
            <Part>
                <PartNumber>3</PartNumber>
                <LastModified>2020-03-25T10:07:13.000Z</LastModified>
                <ETag>&quot;762890d6c9a871b7bd136037cb2260cd&quot;</ETag>
                <Size>1048576</Size>
            </Part>
            <StorageClass>Standard</StorageClass>
            <MaxParts>1000</MaxParts>
            <IsTruncated>false</IsTruncated>
</ListPartsResult>
﻿

Was this page helpful?

You can also Contact Sales or Submit a Ticket for help.

Yes

tencent cloud

Overview

Requests

Request example

Request headers

Request fields

Request body

Response

Response headers

Response body

Error codes

Examples

Request

Response

About Tencent Cloud

Help & Support

Resources

User Center

Parameter	Description	Type	Required
uploadId	Multipart upload ID obtained from the `Initiate Multipart Upload` API	string	Yes
encoding-type	Encoding type for the returned value	string	No
max-parts	Maximum number of entries to be returned at a time. Maximum value: `1000`. Default value: `1000`.	int	No
part-number-marker	By default, parts are listed in UTF-8 binary order, starting from the part after the marker.	string	No

Node Name (Keyword)	Parent Node	Description	Type
ListPartsResult	None	Stores the response of `List Parts`.	Container

tencent cloud

Sign Up

Log in

Compute

Microservice

Data Migration

Database SaaS Tool

Data Security

Application Security

Big Data

Voice Technology

Internet of Things

Stream Services

Cloud Real-time Rendering

Cloud Resource Management

More

Edge Computing

Serverless

Relational Database

Networking

Business Security

Domains & Websites

Face Recognition

AI Platform Service

Middleware

Media On-Demand

Game Services

Management and Audit Tools

Container

Essential Storage Service

Enterprise Distributed DBMS

CDN and Acceleration

Security Services

Enterprise Applications

Tencent Big Model

Natural Language Processing

Communication

Media Process Services

Education Sevices

Developer Tools

Distributed cloud

Data Process and Analysis

NoSQL Database

Network Security

Cloud Security

Office Collaboration

Image Creation

Optical Character Recognition

Interactive Video Services

Media SDK

Medical Services

Monitor and Operation

Overview

Requests

Request example

Request headers

Request fields

Request body

Response

Response headers

Response body

Error codes

Examples

Request

Response

About Tencent Cloud

Help & Support

Resources

User Center