列举分段上传任务
功能说明
查询桶内分段上传任务。
命令结构
- 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 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 is: 0 Upload number is: 6
- 更多运行示例,请参见列举分段上传任务示例。
参数说明
参数 |
约束 |
描述 |
---|---|---|
bucket |
必选 |
桶名。 |
prefix |
可选 |
列举分段上传任务时的对象名前缀。
说明:
如果为空,则表示列举桶内所有分段上传任务。 |
s |
附加参数,可选 |
以精简格式显示查询结果。
说明:
在精简格式下,返回结果只包含分段上传任务对象名和UploadId。 |
d |
附加参数,可选 |
仅列举当前目录下的分段上传任务和子目录,而非递归列举所有分段上传任务和子目录。 |
m |
附加参数,必选 |
列举桶内分段上传任务。 |
a |
附加参数,可选 |
同时列举桶内对象和桶内分段上传任务。 |
marker |
附加参数,可选 |
列举桶内分段上传任务的起始位置,返回结果是分段上传任务对象名按照字典序排序后该参数以后的所有分段上传任务。
说明:
请参考列举分段上传任务示例理解该参数的使用方式。 |
uploadIdMarker |
附加参数,可选 |
列举桶内分段上传任务的起始位置,必须与marker配合使用。返回结果是对象名和UploadId按照字典序排序后该参数以后的所有分段上传任务。 |
limit |
附加参数,可选 |
列举结果的最大个数,小于等于0表示列举所有结果。
说明:
如果桶内分段上传任务较多,建议设置该值限制每次列举的分段上传任务个数,列举结束后,如果仍有分段上传任务,会在结果中返回下次请求的marker和uploadIdMarker,用于继续列举剩余的分段上传任务。 |
format |
附加参数,可选 |
指定以自定义格式打印列举结果。当前仅支持值[default],指定列举结果在一行显示。 |
config |
附加参数,可选 |
运行当前命令时的自定义配置文件,可支持的配置参数请参考配置参数说明。 |