ListParts
    • PDF

    ListParts

    • PDF

    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
    

    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
    

    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
    
    <?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>
    

    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.