List Parts

Last updated: 2021-03-01 17:42:37

    Description

    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.

    Request

    Sample request

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

    Note:

    Authorization: Auth String (See Request Signature for details.)

    Request headers

    This API only uses common request headers. For more information, please see Common Request Headers.

    Request parameters

    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 parts to return at a time. Defaults to 1000. string 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 returns only common response headers. For more information, please see 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 the Container node 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 parts returned at a time string
    IsTruncated ListPartsResult Indicates whether the returned list is truncated. Valid values: true, 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 initiator string
    DisplayName ListPartsResult.Initiator Username of the initiator string

    Content of the Container node 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 the Container node 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, please see Error Codes.

    Sample

    Request

    GET /exampleobject?uploadId=1585130821cbb7df1d11846c073ad648e8f33b087cec2381df437acdc833cf654b9ecc6361 HTTP/1.1
    Host: exam