tencent cloud

Feedback

List Parts

Last updated: 2024-06-12 15:10:38

    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>