Contents:
Description
This API (List Parts) is used to query the uploaded parts in the specified multipart upload, i.e., listing all successfully uploaded parts in the multipart upload with the specified UploadId.
Request
Sample Request
GET /<ObjectKey>?uploadId=UploadId HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
Authorization: Auth String (see Request Signature for details).
Request Headers
Common Headers
The implementation of this request operation uses a common request header. For more information on common request headers, see Common Request Headers.
Special Headers
This request operation has no special request headers.
Request Parameters
Name | Type | Required | Description |
---|---|---|---|
UploadId | String | Yes | ID of this multipart upload; when the Initiate Multipart Upload API is used to initialize a multipart upload, an uploadId will be obtained, which not only uniquely identifies the data but also identifies the data position in the entire file |
encoding-type | string | No | Specifies the encoding method of the return value |
max-parts | string | No | Maximum number of entries returned at a time. Default value: 1,000 |
part-number-marker | string | No | By default, entries are listed in UTF-8 binary order, and the entry list starts at marker |
Request Body
The request body of this request is empty.
Response
Response Headers
Common Response Headers
This response contains a common response header. For more information on common response headers, see Common Response Headers.
Special Response Headers
This response has no special response headers.
Response Body
If the query succeeds, the application/xml data will be returned, including the information of finished 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>
<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 detailed data are described as follows:
Node Name (Keyword) | Parent Node | Description | Type |
---|---|---|---|
ListPartsResult | None | Stores all information of the List Parts request result | Container |
Content of the Container node ListPartsResult:
Node Name (Keyword) | Parent Node | Description | Type |
---|---|---|---|
Bucket | ListPartsResult | Name of the destination bucket for the multipart upload, which is formed by connecting the user-defined string and system-generated APPID with a dash, such as examplebucket-1250000000 | string |
Encoding-Type | ListPartsResult | Encoding method | string |
Key | ListPartsResult | Object name | string |
UploadId | ListPartsResult | Identifies the ID of this multipart upload | string |
Initiator | ListPartsResult | Identifies the owner of the parts | Container |
Owner | ListPartsResult | Identifies the owner of the parts | Container |
StorageClass | ListPartsResult | Indicates the storage class of the parts; enumerated value: STANDARD, STANDARD_IA, ARCHIVE | string |
PartNumberMarker | ListPartsResult | By default, entries are listed in UTF-8 binary order, and the entry list starts at marker | string |
NextPartNumberMarker | ListPartsResult | If the returned entries are truncated, then NextMarker is the starting point of the next entry | string |
MaxParts | ListPartsResult | Maximum number of entries returned at a time | string |
IsTruncated | ListPartsResult | Whether response entries are truncated, which is a boolean value (true or false) | boolean |
Part | ListPartsResult | Metadata | Container |
Content of the Container node Initiator:
Node Name (Keyword) | Parent Node | Description | Type |
---|---|---|---|
ID | ListPartsResult.Initiator | Unique ID of the creator | string |
DisplayName | ListPartsResult.Initiator | Creator's username | string |
Content of the Container node Owner:
Node Name (Keyword) | Parent Node | Description | Type |
---|---|---|---|
ID | ListPartsResult.Owner | Unique ID of the creator | string |
DisplayName | ListPartsResult.Owner | Creator's username | string |
Content of the Container node Part:
Node Name (Keyword) | Parent Node | Description | Type |
---|---|---|---|
PartNumber | ListPartsResult.Part | Part number | string |
LastModified | ListPartsResult.Part | Last modified time of the part | string |
ETag | ListPartsResult.Part | MD5 checksum of the part | string |
Size | ListPartsResult.Part | Part size in bytes | string |
Samples
Request
GET /exampleobject?uploadId=14846420620b1f381e5d7b057692e131dd8d72dfa28f2633cfbbe4d0a9e8bd0719933545b0&max-parts=1 HTTP/1.1
Host:examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Wed,18 Jan 2017 16:17:03 GMT
Authorization:q-sign-algorithm=sha1&q-ak=AKIDDNMEycgLRPI2axw9xa2Hhx87wZ3MqQCn&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>