Listing Multipart Upload Tasks

Function

You can use this command to query multipart upload tasks in a bucket.

Command Line Structure

Examples

Parameter Description

Parameter

Optional or Mandatory

Description

bucket

Mandatory

The bucket name

prefix

Optional

The object name prefix for listing multipart uploads

NOTE:

If this parameter is left blank, all multipart upload tasks in the bucket are listed.

s

Optional (additional parameter)

Displays simplified query result.

NOTE:

In the simplified format, the returned result contains only the object name and upload ID of the multipart upload.

d

Optional (additional parameter)

Lists only the multipart upload tasks and sub-directories in the current directory are listed, instead of recursively listing all the multipart upload tasks and sub-directories.

m

Mandatory (additional parameter)

Lists multipart upload tasks in the bucket.

a

Optional (additional parameter)

Lists the objects and the multipart upload tasks in the bucket.

marker

Optional (additional parameter)

The start position for listing multipart upload tasks in a bucket. The multipart upload tasks following this start position are sorted in lexicographical order by object name.

NOTE:

For details about how to use this parameter, see Listing Multipart Upload Tasks.

uploadIdMarker

Optional (additional parameter)

The start position for listing multipart upload tasks in a bucket. This parameter must be used together with marker. The multipart upload tasks following this start position are sorted in lexicographical order by object name and upload ID.

limit

Optional (additional parameter)

The maximum number of objects that can be listed. If the value is less than or equal to 0, all objects are listed.

NOTE:

If there are a large number of multipart upload tasks in a bucket, you are advised to set this parameter to limit the number of multipart upload tasks each time. If not all tasks are listed, marker and uploadIdMarker of the next request will be returned in the result, which you can use to list the remaining tasks.

config

Optional (additional parameter)

The user-defined configuration file for executing the current command. For details about parameters that can be configured, see Configuration Parameters.

payer

Optional (additional parameter)

Specifies that requester pays is enabled.