Lists all MultipartUpload events that are being executed, that is, MultipartUpload events that have been initiated but are not completed or aborted.

The result returned by OSS includes the information about a maximum of 1,000 MultipartUpload events. If you want to specify the number of MultipartUpload events included in the results returned by OSS, you can add the max-uploads parameter in the request. In addition, the IsTruncated element in the results returned by OSS indicates whether other information about other MultipartUpload events are included.

Request syntax

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

Request parameters

Parameter Type Description
delimiter String Indicates the character used to group object names. All those objects whose names contain the specified prefix and behind which the delimiter occurs for the first time act as a group of elements - CommonPrefixes.
max-uploads String Specifies the maximum number of MultipartUpload tasks returned by one response. If this parameter is not specified, the default value 1,000 is used. The max-uploads value cannot exceed 1,000. 
key-marker String This parameter is used together with the upload-id-marker parameter to specify the starting position of the returned result.
  • If the upload-id-marker parameter is not set, the query result includes MultipartUpload evemts in which all object names are greater than the value of the key-marker parameter in the lexicographic order.
  • If the upload-id-marker parameter is set, the query result includes MultipartUpload events in which all object names are greater than the value of the key-marker parameter in the lexicographic order, and all MultipartUpload events in which the object names are the same as the value of the key-marker parameter, but the Upload IDs are greater than the value of the upload-id-marker parameter.
prefix String Limits the prefix of the returned object key. Note that if you specify a prefix in the request, the prefix is included in the returned key.
upload-id-marker String This parameter is used together with the key-marker parameter to specify the starting position of the returned result.
  • If the key-marker parameter is not set, OSS ignores the upload-id-marker parameter.
  • If the key-marker parameter is set, the query result includes MultipartUpload events in which all object names are greater than the value of the key-marker parameter in the lexicographic order, and all MultipartUpload events in which the object names are the same as the value of the key-marker parameter, but the Upload IDs are greater than the value of the upload-id-marker parameter.
encoding-type String Indicates that the returned results are encoded and specifies the encoding type. Delimiter, KeyMarker, Prefix, NextKeyMarker, and Key use UTF-8 characters, but the XML 1.0 Standard does not support parsing certain control characters, such as characters with ASCII values ranging from 0 to 10. If some elements in the returned results contain control characters that are not supported by the XML 1.0 Standard, encoding-type can be specified to encode these elements, such as Delimiter, KeyMarker, Prefix, NextMarker, and Key.

Default: None

Response elements

Name Type Description
ListMultipartUploadsResult Container Indicates the container that stores the result of the ListMultipartUpload request. 

Sub-nodes: Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MasUploads, Delimiter, Prefix, CommonPrefixes, IsTruncated, Upload

Parent node: None

Bucket String Indicates the bucket name.

Parent node: ListMultipartUploadsResult

EncodingType String Indicates the encoding type for the returned results. If encoding-type is specified in the request, those elements including Delimiter, KeyMarker, Prefix, NextKeyMarker, and Key are encoded in the returned result.

Parent node: ListMultipartUploadsResult

KeyMarker String Indicates the position of the starting object in the list. 

Parent node: ListMultipartUploadsResult

UploadIdMarker String Indicates the position of the starting Upload ID in the list.

Parent node: ListMultipartUploadsResult

NextKeyMarker String If not all results are returned this time, the response includes the NextKeyMarker element to indicate the value of KeyMarker in the next request.

Parent node: ListMultipartUploadsResult

NextUploadMarker String If not all results are returned this time, the response includes the NextUploadMarker element to indicate the value of UploadMarker in the next request.

Parent node: ListMultipartUploadsResult

MaxUploads Integer Indicates the maximum upload number returned by the OSS.

Parent node: ListMultipartUploadsResult

IsTruncated enumerative string Indicates whether the returned MultipartUpload event list is truncated. The “true” value indicates that not all results are returned; “false” indicates that all results are returned.

Valid values: false, true

Default: false

Parent node: ListMultipartUploadsResult

Upload Container Indicates the container that stores the information about the MultipartUpload events.

Sub-nodes: Key, UploadId, Initiated

Parent node:ListMultipartUploadsResult

Key String Indicates the name of an object for which a MultipartUpload event is initiated.

Parent node: Upload

UploadId String Indicates the ID of a MultipartUpload event.

Parent node: Upload

Initiated Date Indicates the time when a Multipart Upload event is initiated.

Parent node: Upload

Detail analysis

  • The maximum value of the max-uploads parameter is 1,000.
  • The results returned by OSS are listed in ascending order based on the lexicographic order of object names; for the same object, the results are listed in ascending time order.
  • Using the prefix parameter, you can flexibly manage objects in a bucket in groups (similar to the folder function).
  • A ListMultipartUploads request supports five request parameters: prefix, marker, delimiter, upload-id-marker, and max-uploads. Based on the combinations of these parameters, you can set rules for querying MultipartUpload events to obtain the expected query results.

Examples

Request example:

Get /? uploads HTTP/1.1
HOST: OSS-example.
Date: Thu, 23 Feb 2012 06:14:27 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:JX75CtQqsmBBz+dcivn7kwBMvOY=

Response example:

HTTP/1.1 200 
Server: AliyunOSS
Connection: keep-alive
Content-length: 1839
Content-type: application/xml
x-oss-request-id: 58a41847-3d93-1905-20db-ba6f561ce67a
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>0004B999EF5A239BB9138C6227D69F95</UploadId>
        <Initiated>2012-02-23T04:18:23.000Z</Initiated>
    </Upload>
    <Upload>
        <Key>oss.avi</Key>
        <UploadId>0004B99B8E707874FC2D692FA5D77D3F</UploadId>
        <Initiated>2012-02-23T06:14:27.000Z</Initiated>
    </Upload>
</ListMultipartUploadsResult>