# 列举分段上传任务
#### 功能说明
查询桶内分段上传任务。
#### 命令结构
- 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]
  ```
  
- macOS/Linux操作系统
  ```
  ./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]
  ```
  
 
#### 运行示例
- 以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: 0
  Upload number: 6
  ```
  

- 更多运行示例，请参见[常见示例](https://support.huaweicloud.com/utiltg-obs/obs_11_0027.html)。
 
#### 参数说明
| **参数**         | **约束**  | **描述**                                                                                                                                                                                                       |
|:---|:---|:---|
| bucket         | 必选      | 桶名。                                                                                                                                                                                                          |
| prefix         | 可选      | 列举分段上传任务时的对象名前缀。 说明： 如果为空，则表示列举桶内所有分段上传任务。                                                                                                       |
| s              | 附加参数，可选 | 以精简格式显示查询结果。 说明： 在精简格式下，返回结果只包含分段上传任务对象名和UploadId。                                                                                               |
| d              | 附加参数，可选 | 仅列举当前目录下的分段上传任务和子目录，而非递归列举所有分段上传任务和子目录。                                                                                                                                                                      |
| m              | 附加参数，必选 | 列举桶内分段上传任务。                                                                                                                                                                                                  |
| a              | 附加参数，可选 | 同时列举桶内对象和桶内分段上传任务。                                                                                                                                                                                           |
| marker         | 附加参数，可选 | 列举桶内分段上传任务的起始位置，返回结果是分段上传任务对象名按照字典序排序后该参数以后的所有分段上传任务。 说明： 请参考[列举分段上传任务示例](https://support.huaweicloud.com/utiltg-obs/obs_11_0032.html)理解该参数的使用方式。 |
| uploadIdMarker | 附加参数，可选 | 列举桶内分段上传任务的起始位置，必须与marker配合使用。返回结果是对象名和UploadId按照字典序排序后该参数以后的所有分段上传任务。                                                                                                                                       |
| limit          | 附加参数，可选 | 列举结果的最大个数，小于等于0表示列举所有结果。 说明： 如果桶内分段上传任务较多，建议设置该值限制每次列举的分段上传任务个数，列举结束后，如果仍有分段上传任务，会在结果中返回下次请求的marker和uploadIdMarker，用于继续列举剩余的分段上传任务。             |
| format         | 附加参数，可选 | 指定以自定义格式打印列举结果。当前仅支持值\[default\]，指定列举结果在一行显示。                                                                                                                                                                |
| config         | 附加参数，可选 | 运行当前命令时的自定义配置文件。可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。                                                                                                            |
| e              | 附加参数，可选 | 指定终端节点。                                                                                                                                                                                                      |
| i              | 附加参数，可选 | 指定用户的AK。                                                                                                                                                                                                     |
| k              | 附加参数，可选 | 指定用户的SK。                                                                                                                                                                                                     |
| t              | 附加参数，可选 | 指定用户的securitytoken。                                                                                                                                                                                          |