List Bucket Multipart Uploads

Returns a list of the current in-progress multipart uploads. For example, when the application has initiated a multipart upload, but the service hasn't completed all the uploads yet.

GET /?uploads HTTP/1.1
Host: {bucket}.{region}.cdn77-storage.com

Parameters

NameDescription
Prefixstring

Returns in-progress uploads whose keys contain the specified prefix.

Delimiterstring

The delimiter between the prefix and the rest of the object name.

Key-markerstring

The beginning marker for the list of uploads.

Max-keysinteger

The maximum number of in-progress uploads. The default is 1000.

Max-uploadsinteger

The maximum number of multipart uploads. The range is 1-1000. The default is 1000.

upload-id-markerstring

Ignored if key-marker is not specified. Specifies the ID of first upload to list in lexicographical order at or following the ID.

Response Entities

NameDescription
ListMultipartUploadsResultnone

A container for the results.

ListMultipartUploadsResult.Prefixstring

The prefix specified by the prefix request parameter, if any.

Bucketstring

The bucket that will receive the bucket contents.

KeyMarkerstring

The key marker specified by the key-marker request parameter (if any).

UploadIdMarkerstring

The marker specified by the upload-id-marker request parameter (if any).

NextKeyMarkerstring

The key marker to use in a subsequent request if IsTruncated is true.

NextUploadIdMarkerstring

The upload ID marker to use in a subsequent request if IsTruncated is true.

MaxUploadsinteger

The max uploads specified by the max-uploads request parameter.

Delimiterstring

If set, objects with the same prefix will appear in the CommonPrefixes list.

IsTruncatedboolean

If true, only a subset of the bucket's upload contents were returned.

Uploadnone

A container for Key, UploadId, InitiatorOwner, StorageClass, and Initiated elements.

Keystring

The key of the object once the multipart upload is complete.

UploadIdstring

The ID that identifies the multipart upload.

Initiatornone

Contains the ID and DisplayName of the user who initiated the upload.

DisplayNamestring

The initiator's display name.

IDstring

The initiator's ID.

Ownernone

A container for the ID and DisplayName of the user who owns the uploaded object.

StorageClassstring

The method used to store the resulting object. STANDARD or REDUCED_REDUNDANCY

Initiatednone

The date and time the user initiated the upload.

CommonPrefixesnone

If multiple objects contain the same prefix, they will appear in this list.

CommonPrefixes.Prefixstring

The substring of the key after the prefix as defined by the prefix request parameter.

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Bucket>bucket</Bucket>
    <KeyMarker></KeyMarker>
    <UploadIdMarker></UploadIdMarker>
    <NextKeyMarker>my-movie.m2ts</NextKeyMarker>
    <NextUploadIdMarker>YW55IGlkZWEgd2h5IGVsdmluZydzIHVwbG9hZCBmYWlsZWQ</NextUploadIdMarker>
    <MaxUploads>3</MaxUploads>
    <IsTruncated>true</IsTruncated>
    <Upload>
        <Key>my-divisor</Key>
        <UploadId>XMgbGlrZSBlbHZpbmcncyBub3QgaGF2aW5nIG11Y2ggbHVjaw</UploadId>
        <Initiator>
            <ID>arn:aws:iam::111122223333:user/user1-11111a31-17b5-4fb7-9df5-b111111f13de</ID>
            <DisplayName>user1-11111a31-17b5-4fb7-9df5-b111111f13de</DisplayName>
        </Initiator>
        <Owner>
            <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
            <DisplayName>OwnerDisplayName</DisplayName>
        </Owner>
        <StorageClass>STANDARD</StorageClass>
        <Initiated>2010-11-10T20:48:33.000Z</Initiated>
    </Upload>
    <Upload>
        <Key>my-movie.m2ts</Key>
        <UploadId>VXBsb2FkIElEIGZvciBlbHZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA</UploadId>
        <Initiator>
            <ID>b1d16700c70b0b05597d7acd6a3f92be</ID>
            <DisplayName>InitiatorDisplayName</DisplayName>
        </Initiator>
        <Owner>
            <ID>b1d16700c70b0b05597d7acd6a3f92be</ID>
            <DisplayName>OwnerDisplayName</DisplayName>
        </Owner>
        <StorageClass>STANDARD</StorageClass>
        <Initiated>2010-11-10T20:48:33.000Z</Initiated>
    </Upload>
    <Upload>
        <Key>my-movie.m2ts</Key>
        <UploadId>YW55IGlkZWEgd2h5IGVsdmluZydzIHVwbG9hZCBmYWlsZWQ</UploadId>
        <Initiator>
            <ID>arn:aws:iam::444455556666:user/user1-22222a31-17b5-4fb7-9df5-b222222f13de</ID>
            <DisplayName>user1-22222a31-17b5-4fb7-9df5-b222222f13de</DisplayName>
        </Initiator>
        <Owner>
            <ID>b1d16700c70b0b05597d7acd6a3f92be</ID>
            <DisplayName>OwnerDisplayName</DisplayName>
        </Owner>
        <StorageClass>STANDARD</StorageClass>
        <Initiated>2010-11-10T20:49:33.000Z</Initiated>
    </Upload>
</ListMultipartUploadsResult>

Updated on 13th November, 2026