ListMultipartUploads

Prev Next

Available in Classic and VPC

Get the list of ongoing multipart uploads.

Request

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

Method URI
GET -

Request headers

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

Request query parameters

You can use the following query parameters with your request:

Field Type Required Description
uploads String Required Request multipart upload information retrieval.
  • Enter only keys without values.
max-uploads String Optional Number of items per page
  • 1-1000
prefix String Optional Object name prefix
key-marker String Optional Query start criteria (object name)
  • The NextKeyMarker value from the previous response result or a random string can be entered.
upload-id-marker String Optional Query start criteria (multipart upload ID)
  • NextUploadIdMarker value from the previous response result
  • When using it, it must be entered with key-marker.

Request example

The request example is as follows:

GET /?uploads&max-uploads=2 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
ListMultipartUploadsResult Object - Multipart upload list query results
ListMultipartUploadsResult.Bucket String - Bucket name
ListMultipartUploadsResult.KeyMarker String - Query start criteria (object name)
  • Display the input value if key-marker is entered.
ListMultipartUploadsResult.UploadIdMarker String - Query start criteria (multipart upload ID)
  • Display the input value if upload-id-marker is entered.
ListMultipartUploadsResult.NextKeyMarker String - Next query criteria (object name)
  • If IsTruncated is true, enter that value in key-marker of the next request.
ListMultipartUploadsResult.Prefix String - Object name prefix
ListMultipartUploadsResult.NextUploadIdMarker String - Next query criteria (multipart upload ID)
  • If IsTruncated is true, enter that value in upload-id-marker of the next request.
ListMultipartUploadsResult.MaxUploads Integer - Number of items per page
ListMultipartUploadsResult.IsTruncated Boolean - Whether next page exists
  • true | false
    • true: It exists.
    • false: It doesn't exist.
ListMultipartUploadsResult.Upload Array - Multipart upload list

Upload

The following describes Upload.

Field Type Required Description
Key String - Object name
UploadId String - Multipart upload ID
  • UUID format
StorageClass String - Storage class
  • STANDARD | DEEP_ARCHIVE
    • STANDARD: Standard Class
    • DEEP_ARCHIVE: Archive Class
Initiated String - Upload start date and time
  • ISO 8601 format

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"?>
<ListMultipartUploadsResult>
    <Bucket>bucket</Bucket>
    <KeyMarker></KeyMarker>
    <UploadIdMarker></UploadIdMarker>
    <NextKeyMarker>F1/object.csv</NextKeyMarker>
    <Prefix></Prefix>
    <NextUploadIdMarker>6fb36081-****-****-****-9cc2c468d0e9</NextUploadIdMarker>
    <MaxUploads>2</MaxUploads>
    <IsTruncated>true</IsTruncated>
    <Upload>
        <Key>F1/object000.csv</Key>
        <UploadId>7c1f5ac6-****-****-****-9cc2c464a269</UploadId>
        <StorageClass>STANDARD</StorageClass>
        <Initiated>2025-04-29T05:33:30Z</Initiated>
    </Upload>
    <Upload>
        <Key>F1/object.csv</Key>
        <UploadId>6fb36081-****-****-****-9cc2c468d0e9</UploadId>
        <StorageClass>STANDARD</StorageClass>
        <Initiated>2025-04-29T05:40:19Z</Initiated>
    </Upload>
</ListMultipartUploadsResult>