tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Cloud Object Storage
    Documentation
    Download PDF

    List Parts

    Last updated: 2023-03-02 15:11:45
    Download PDF

      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.

      API Explorer (recommended)
      Debug
      Tencent Cloud API Explorer makes it easy for you to make online API calls, verify signatures, generate SDK code, and search for APIs. You can use it to query the request and response of each API call and generate sample SDK codes for the call.

      Requests

      Request example

      GET /<ObjectKey>?uploadId=UploadId HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
      Note：

      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>"39270a968a357d24207e9911162507eb"</ETag>
                <Size>1048576</Size>
            </Part>
            <Part>
                <PartNumber>2</PartNumber>
                <LastModified>2020-03-25T10:07:13.000Z</LastModified>
                <ETag>"d899fbd1e06109ea2e4550f5751c88d6"</ETag>
                <Size>1048576</Size>
            </Part>
            <Part>
                <PartNumber>3</PartNumber>
                <LastModified>2020-03-25T10:07:13.000Z</LastModified>
                <ETag>"762890d6c9a871b7bd136037cb2260cd"</ETag>
                <Size>1048576</Size>
            </Part>
            <StorageClass>Standard</StorageClass>
            <MaxParts>1000</MaxParts>
            <IsTruncated>false</IsTruncated>
</ListPartsResult>
      Contact Us

      Contact our sales team or business advisors to help your business.

      Contact Us
      Technical Support

      Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

      Submit a Ticket
      7x24 Phone Support
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      Privacy PolicyLegalCookie Policy