MENU
      ListParts

        ListParts


        Article summary

        Available in Classic and VPC

        You can view the parts of an object uploaded to a bucket with a multipart upload.

        Requests

        The following describes the request format for the endpoint. The request format is as follows.

        MethodURI
        GET/{bucket-name}/{object-name}

        Request syntax

        The request syntax is as follows.

        GET https://{endpoint}/{bucket-name}/{object-name}?uploadId={uploadId} # path style
        GET https://{bucket-name}.{endpoint}/{object-name}?uploadId={uploadId} # virtual host style
        HTTP

        Request headers

        For headers common to all Object Storage APIs, see Object Storage common headers.

        Request path parameters

        The following describes the parameters.

        FieldTypeRequiredDescription
        bucket-nameStringRequiredName of the bucket where the object is stored
        object-nameStringRequiredName of the object that ran the multipart upload

        Request query parameters

        The following describes the parameters.

        FieldTypeRequiredDescription
        uploadIdStringRequiredUpload ID received by running the InitiateMultipartUpload API
        max-partsStringOptionalMaximum number of parts retrieved
        • Up to 1000
        part-number-markerIntegerOptionalStarting point of the part being viewed
        • View parts with a number greater than the entered value
        • 0 - 1,000 (default: 1000)
        Note

        If the total number of parts exceeds 1000 or the max-parts specification, the IsTruncated item will be marked as true, and you can specify NextPartNumberMarker in the part-number-marker parameter in subsequent requests to retrieve the list of parts following the list retrieved in the previous request.

        Request example

        The following is a sample request.

        GET /some-bucket/multipart-object-123?uploadId=01000180-3f73-ad2d-2ed4-8bf4b9e5f6b5&max-parts=2 HTTP/1.1
        Authorization: {authorization-string}
        x-amz-date: 20220419T014350Z
        Host: kr.object.ncloudstorage.com
        HTTP

        Responses

        The following describes the response format.

        Response headers

        For response headers common to all Object Storage APIs, see Object Storage common response headers.

        Response status codes

        For response status codes common to all Object Storage APIs, see Object Storage response status codes.

        Response example

        The following is a sample response.

        HTTP/1.1 200 OK
        Date: Tue, 19 Apr 2022 01:43:50 GMT
        Accept-Ranges: bytes
        x-amz-request-id: e5767394-0d66-4ce0-b53f-d0d449db0a24
        Content-Type: application/xml
        Content-Length: 668
        HTTP
        <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
        <ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
            <Bucket>some-bucket</Bucket>
            <Key>mutipart-object-123</Key>
            <UploadId>01000180-3f73-ad2d-2ed4-8bf4b9e5f6b5</UploadId>
            <Initiator>
                <ID>{owner-user-id}</ID>
                <DisplayName>{owner-user-id}</DisplayName>
            </Initiator>
            <Owner>
                <ID>{owner-user-id}</ID>
                <DisplayName>{owner-user-id}</DisplayName>
            </Owner>
            <StorageClass>STANDARD</StorageClass>
            <NextPartNumberMarker>2</NextPartNumberMarker>
            <MaxParts>2</MaxParts>
            <IsTruncated>true</IsTruncated>
            <Part>
                <PartNumber>1</PartNumber>
                <LastModified>2022-04-19T01:33:30.285Z</LastModified>
                <ETag>"1c5169091bb3ca7440f67c603a1f60b5"</ETag>
                <Size>143693806</Size>
            </Part>
            <Part>
                <PartNumber>2</PartNumber>
                <LastModified>2022-04-19T02:14:11.202Z</LastModified>
                <ETag>"842169123bb3gr7440f67c546b1a85b7"</ETag>
                <Size>158964528</Size>
            </Part>
        </ListPartsResult>
        XML

        Was this article helpful?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.