Listing Multipart Upload Tasks

Updated on 2025-02-10 GMT+08:00

View PDF

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]

In Linux or macOS

./obsutil ls obs://bucket[/prefix] [-s] [-d] -m [-a] [-uploadIdMarker=xxx] [-marker=xxx] [-limit=1] [-format=default] [-config=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
UploadId
obs://bucket-test/aaa                                  2018-11-27T03:49:07Z
standard            000001675348ED21860C3F61EF955BD3

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

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

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

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

obs://bucket-test/test11/20GB.txt                      2018-11-27T08:21:26Z
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 .

Parent topic: Object Commands

Previous topic: Resuming a Failed Download Task

Next topic: Deleting a Multipart Upload Task

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot