Updated on 2024-09-03 GMT+08:00

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 is: 0
    Upload number is: 6

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 a command. For details about parameters that can be configured, 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.