You can call this operation to list all ongoing multipart upload tasks that have been initiated but canceled or not completed.

To specify the number of tasks that are returned in the response from OSS, you can add the max-uploads parameter to the request. The IsTruncated element indicates whether all required multipart upload tasks are returned.
Note
  • The maximum value of max-uploads is 1000, indicating that a maximum of 1,000 multipart upload tasks can be returned in the response.
  • The results returned by OSS are listed in ascending alphabetical order of object names. If multipart upload tasks involve the same object, the results are listed in ascending order of time when the multipart upload tasks were initiated.

Request syntax

Get /?uploads HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature

Request parameters

Note ListMultipartUploads supports the following parameters: prefix, marker, delimiter, upload-id-marker, and max-uploads. You can use one or more of the preceding parameters to configure rules to query multipart upload tasks so that results that meet conditions are returned.
Parameter Type Description
delimiter String The delimiter used to group objects by name. CommonPrefixes specifies a set of substrings of object names. The substrings start with the prefix and end with the next occurrence of the specified delimiter.
max-uploads String The maximum number of multipart upload tasks to be returned in a single request. The maximum value of this parameter is 1000. Default value: 1000.
key-marker String The name of the object corresponding to the multipart upload task after which the listing begins. This parameter is used together with the upload-id-marker parameter.
  • If the upload-id-marker parameter is not set, OSS returns all multipart upload tasks in which object names come after the key-marker value in alphabetical order.
  • If the upload-id-marker parameter is set, the response includes the following tasks:
    • Multipart upload tasks in which object names come after the key-marker value in alphabetical order
    • Multipart upload tasks in which object names are equal to the key-marker parameter value in alphabetical order but upload IDs are greater than the upload-id-marker parameter value
prefix String The prefix to be contained in the names of returned objects so that only objects with the specified prefix are listed. Note that the returned object names contain the prefix that is specified in the request.
Note You can use prefixes to group and manage objects in bucket in the same way you manage a folder in a file system.
upload-id-marker String The upload ID of the multipart upload task after which the listing begins.
  • If the key-marker parameter is not set, OSS ignores the upload-id-marker parameter.
  • If the key-marker parameter is set, the response includes the following tasks:
    • Multipart upload tasks in which object names come after the key-marker value in alphabetical order
    • Multipart upload tasks in which object names are equal to the key-marker parameter value in alphabetical order but upload IDs are greater than the upload-id-marker parameter value
encoding-type String The encoding type of the object name in the response. Values of Delimiter, KeyMarker, Prefix, NextKeyMarker, and Key can be encoded in UTF-8. However, the XML 1.0 standard cannot be used to parse certain control characters, such as characters with an ASCII value 0 to 10. You can set the encoding-type parameter to encode values of Delimiter, KeyMarker, Prefix, NextKeyMarker, and Key in the response.

Default value: null

Response elements

Element Type Description
ListMultipartUploadsResult Container The container that stores the response to the ListMultipartUpload request.

Child node: Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MasUploads, Delimiter, Prefix, CommonPrefixes, IsTruncated, and Upload

Parent node: none

Bucket String The name of the bucket.

Parent node: ListMultipartUploadsResult

EncodingType String The encoding type of the object name in the response. If encoding-type is specified in the request, values of Delimiter, KeyMarker, Prefix, NextKeyMarker, and Key in the response are encoded.

Parent node: ListMultipartUploadsResult

KeyMarker String The name of the object corresponding to the multipart upload task after which the listing begins.

Parent node: ListMultipartUploadsResult

UploadIdMarker String The upload ID of the multipart upload task after which the listing begins.

Parent node: ListMultipartUploadsResult

NextKeyMarker String The value that is used for the key-marker parameter in a subsequent request when the response does not contain all required results.

Parent node: ListMultipartUploadsResult

NextUploadMarker String The value that is used for the upload-id-marker in a subsequent request when the response does not contain all required results.

Parent node: ListMultipartUploadsResult

MaxUploads Integer The maximum number of upload tasks returned by OSS.

Parent node: ListMultipartUploadsResult

IsTruncated Boolean Indicates whether the list of multipart upload tasks returned in the response is truncated. "true" indicates that the response does not contain all required results. "false" indicates that the response contains all required results.

Valid values: false and true

Default value: false

Parent node: ListMultipartUploadsResult

Upload Container The container that stores the information about multipart upload tasks.

Child node: Key, UploadId, and Initiated

Parent node: ListMultipartUploadsResult

Key String The object name in the initialized multipart upload task.

Parent node: Upload

UploadId String The ID of the multipart upload task.

Parent node: Upload

Initiated Date The time when the multipart upload task was initialized.

Parent node: Upload

Examples

Sample requests

Get /?uploads  HTTP/1.1
Host:oss-example. oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 06:14:27 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:JX75CtQqsmBBz+dcivn7kwBM****

Sample responses

HTTP/1.1 200 
Server: AliyunOSS
Connection: keep-alive
Content-length: 1839
Content-type: application/xml
x-oss-request-id: 58a41847-3d93-1905-20db-ba6f561c****
Date: Thu, 23 Feb 2012 06:14:27 GMT

<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
    <Bucket>oss-example</Bucket>
    <KeyMarker></KeyMarker>
    <UploadIdMarker></UploadIdMarker>
    <NextKeyMarker>oss.avi</NextKeyMarker>
    <NextUploadIdMarker>0004B99B8E707874FC2D692FA5D77D3F</NextUploadIdMarker>
    <Delimiter></Delimiter>
    <Prefix></Prefix>
    <MaxUploads>1000</MaxUploads>
    <IsTruncated>false</IsTruncated>
    <Upload>
        <Key>multipart.data</Key>
        <UploadId>0004B999EF518A1FE585B0C9360DC4C8</UploadId>
        <Initiated>2012-02-23T04:18:23.000Z</Initiated>
    </Upload>
    <Upload>
        <Key>multipart.data</Key>
        <UploadId>0004B999EF5A239BB9138C6227D6****</UploadId>
        <Initiated>2012-02-23T04:18:23.000Z</Initiated>
    </Upload>
    <Upload>
        <Key>oss.avi</Key>
        <UploadId>0004B99B8E707874FC2D692FA5D7****</UploadId>
        <Initiated>2012-02-23T06:14:27.000Z</Initiated>
    </Upload>
</ListMultipartUploadsResult>

SDKs

You can call this operation when you use SDK demos in any of the following languages: