ListParts

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.

Method	URI
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.

Field	Type	Required	Description
`bucket-name`	String	Required	Name of the bucket where the object is stored
`object-name`	String	Required	Name of the object that ran the multipart upload

Request query parameters

The following describes the parameters.

Field	Type	Required	Description
`uploadId`	String	Required	Upload ID received by running the InitiateMultipartUpload API
`max-parts`	String	Optional	Maximum number of parts retrieved Up to 1000
`part-number-marker`	Integer	Optional	Starting 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>