ListParts

Prev Next

Available in Classic and VPC

Get the part list of a multipart upload.

Request

This section describes the request format. The method and URI are as follows:

Method URI
GET /{Key}

Request headers

For information about the headers common to all Ncloud Storage APIs, see Ncloud Storage request headers.

Request path parameters

You can use the following path parameters with your request:

Field Type Required Description
Key String Required Object name

Request query parameters

You can use the following query parameters with your request:

Field Type Required Description
max-parts String Optional Number of items per page
  • 1-1000
part-number-marker String Optional Query start criteria
  • Query from this part onwards.
  • The NextPartNumberMarker value from the previous response result
uploadId String Required Multipart upload ID

Request example

The request example is as follows:

GET /object.csv?uploadId=b169de1a-****-****-****-9cc2c464a269 HTTP/1.1
Host: bucket.kr.ncloudstorage.com

Response

This section describes the response format.

Response headers

For information about the headers common to all Ncloud Storage APIs, see Ncloud Storage response headers.

Response body

The response body includes the following data:

Field Type Required Description
ListPartsResult Object - Part list query result
ListPartsResult.Bucket String - Bucket name
ListPartsResult.Key Object - Object name
ListPartsResult.UploadId String - Multipart upload ID
  • UUID format
ListPartsResult.StorageClass String - Storage class
  • STANDARD | DEEP_ARCHIVE
    • STANDARD: Standard Class
    • DEEP_ARCHIVE: Archive Class
ListPartsResult.PartNumberMarker Integer - Query start criteria
ListPartsResult.NextPartNumberMarker Integer - Next query criteria
  • If IsTruncated is true, enter that value in part-number-marker of the next request.
ListPartsResult.MaxParts Integer - Number of items per page
ListPartsResult.IsTruncated Boolean - Whether next page exists
  • true | false
    • true: It exists.
    • false: It doesn't exist.
ListPartsResult.Part Array - Part list

Part

The following describes Part.

Field Type Required Description
PartNumber Integer - Part number
LastModified String - Last modification date and time
  • ISO 8601 format
ETag String - Unique part identifier (entity tag)
Size Integer - Part size (byte)

Response status codes

For information about the HTTP status codes common to all Ncloud Storage APIs, see Common Ncloud Storage response status codes.

Response example

The response example is as follows:

HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult>
    <Bucket>bucket</Bucket>
    <Key>object.csv</Key>
    <UploadId>b169de1a-****-****-****-9cc2c464a269</UploadId>
    <StorageClass>STANDARD</StorageClass>
    <PartNumberMarker>1</PartNumberMarker>
    <NextPartNumberMarker>2</NextPartNumberMarker>
    <MaxParts>1000</MaxParts>
    <IsTruncated>false</IsTruncated>
    <Part>
        <PartNumber>2</PartNumber>
        <LastModified>2025-04-25T07:36:16Z</LastModified>
        <ETag>&#34;d41d8cd98f0**********998ecf8427e&#34;</ETag>
        <Size>0</Size>
    </Part>
</ListPartsResult>