更新时间:2022-05-18 GMT+08:00

列举分段上传任务

功能说明

查询桶内分段上传任务。

命令结构

  • Windows操作系统
    obsutil ls obs://bucket[/prefix] [-s] [-d] -m [-a] [-uploadIdMarker=xxx] [-marker=xxx] [-limit=1] [-format=default] [-config=xxx] 
  • macOS/Linux操作系统
    ./obsutil ls obs://bucket[/prefix] [-s] [-d] -m [-a] [-uploadIdMarker=xxx] [-marker=xxx] [-limit=1] [-format=default] [-config=xxx] 

运行示例

  • 以Windows操作系统为例,运行obsutil ls obs://bucket-test -m -limit=10,查询桶内分段上传任务。
    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

参数说明

参数

约束

描述

bucket

必选

桶名。

prefix

可选

列举分段上传任务时的对象名前缀。

说明:

如果为空,则表示列举桶内所有分段上传任务。

s

附加参数,可选

以精简格式显示查询结果。

说明:

在精简格式下,返回结果只包含分段上传任务对象名和UploadId。

d

附加参数,可选

仅列举当前目录下的分段上传任务和子目录,而非递归列举所有分段上传任务和子目录。

m

附加参数,必选

列举桶内分段上传任务。

a

附加参数,可选

同时列举桶内对象和桶内分段上传任务。

marker

附加参数,可选

列举桶内分段上传任务的起始位置,返回结果是分段上传任务对象名按照字典序排序后该参数以后的所有分段上传任务。

说明:

请参考列举分段上传任务示例理解该参数的使用方式。

uploadIdMarker

附加参数,可选

列举桶内分段上传任务的起始位置,必须与marker配合使用。返回结果是对象名和UploadId按照字典序排序后该参数以后的所有分段上传任务。

limit

附加参数,可选

列举结果的最大个数,小于等于0表示列举所有结果。

说明:

如果桶内分段上传任务较多,建议设置该值限制每次列举的分段上传任务个数,列举结束后,如果仍有分段上传任务,会在结果中返回下次请求的marker和uploadIdMarker,用于继续列举剩余的分段上传任务。

format

附加参数,可选

指定以自定义格式打印列举结果。当前仅支持值[default],指定列举结果在一行显示。

config

附加参数,可选

运行当前命令时的自定义配置文件,可支持的配置参数请参考配置参数说明