Listing Multipart Upload Tasks

Function

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

Command Line Structure

In Windows

obsutil ls obs://bucket[/prefix] [-s] [-d] -m [-a] [-uploadIdMarker=xxx] [-marker=xxx] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

In Linux or macOS

./obsutil ls obs://bucket[/prefix] [-s] [-d] -m [-a] [-uploadIdMarker=xxx] [-marker=xxx] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

Examples

Take the Windows OS as an example. Run the obsutil ls obs://bucket-test -m -limit=10 command to query the multipart upload tasks in the bucket.

obsutil ls obs://bucket-test -m -limit=10

Listing multipart uploads.

Upload list:
Key                                               Initiated
StorageClass        UploadId
obs://bucket-test/aaa                                  2018-11-27T03:49:07Z
standard            000001675348ED21860C3F61EF955BD3

obs://bucket-test/dir1/10GB.txt                        2018-11-07T06:58:09Z
standard            00000166ECF6CF7C860D1DBAF3F76013

obs://bucket-test/dir1/1GB.txt                         2018-11-07T06:58:09Z
standard            00000166ECF6CF6F860B7FBE95D01B03

obs://bucket-test/dir1/50GB.txt                        2018-11-07T06:58:09Z
standard            00000166ECF6CF86860D1DC2C8E8F66B

obs://bucket-test/dir1/5GB.txt                         2018-11-07T06:58:09Z
standard            00000166ECF6CF75860CDA7780CB52C3

obs://bucket-test/test11/20GB.txt                      2018-11-27T08:21:26Z
standard            0000016754423D24860CA8A4D06C2054

Folder number: 0
Upload number: 6

For more examples, see Listing Multipart Upload Tasks.

Parameter Description

Parameter	Optional or Mandatory	Description
bucket	Mandatory	Bucket name
prefix	Optional	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)	Indicates the upload ID after which the multipart upload listing begins. All returned multipart upload tasks are listed in lexicographical order by object name involved in the tasks. NOTE: For details about how to use this parameter, see Listing Multipart Upload Tasks.
uploadIdMarker	Optional (additional parameter)	Indicates the upload ID after which the multipart upload listing begins. This parameter must be used together with marker. All returned multipart upload tasks are listed in lexicographical order by object name and upload ID involved in the tasks.
limit	Optional (additional parameter)	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.
format	Optional (additional parameter)	Prints a listing result in the user-defined format. Currently, the value can only be default, indicating that the listing result is displayed in one row.
config	Optional (additional parameter)	User-defined configuration file for executing the current command. To learn the parameters that can be configured in this file, see Configuration Parameters.
e	Optional (additional parameter)	Specifies the endpoint.
i	Optional (additional parameter)	Specifies the user's AK.
k	Optional (additional parameter)	Specifies the user's SK.
t	Optional (additional parameter)	Specifies the user's security token.