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.comParameters
| Name | Description |
|---|---|
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
| Name | Description |
|---|---|
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