# 列举桶内分段上传任务
#### 功能说明
列举指定桶中所有的初始化后还未合并或还未取消的分段上传任务。
#### 方法定义
```
ObsClient.listMultipartUploads
```
#### 请求参数
| **字段名**        | **类型**                                                                      | **约束** | **说明**                                                                                                                             |
|:---|:---|:---|:---|
| Bucket         | String                                                                      | 必选     | 桶名。                                                                                                                                |
| RequestDate    | String 或 Date | 可选     | 指定请求时间。 说明： 当为String类型时，必须符合ISO8601或RFC822规范。                            |
| Delimiter      | String                                                                      | 可选     | 用于对分段上传任务中的对象名进行分组的字符。对于对象名中包含Delimiter的任务，其对象名（如果请求中指定了Prefix，则此处的对象名需要去掉Prefix）中从首字符至第一个Delimiter之间的字符串将作为一个分组并作为CommonPrefix返回。 |
| Prefix         | String                                                                      | 可选     | 限定返回的分段上传任务中的对象名必须带有Prefix前缀。                                                                                                      |
| MaxUploads     | Number                                                                      | 可选     | 列举分段上传任务的最大数目，取值范围为1\~1000，当超出范围时，按照默认的1000进行处理。                                                                                   |
| KeyMarker      | String                                                                      | 可选     | 表示列举时返回指定的KeyMarker之后的分段上传任务。                                                                                                      |
| UploadIdMarker | String                                                                      | 可选     | 只有与KeyMarker参数一起使用时才有意义，用于指定返回结果的起始位置，即列举时返回指定KeyMarker的UploadIdMarker之后的分段上传任务。                                                   |
   
#### 返回结果（InterfaceResult）
| **字段名**  ||| **类型** | **说明**                                              |
|:--|---|---|:---|:---|
| RequestId ||| String | OBS服务端返回的请求ID。                                      |
| Bucket   ||| String | 桶名。                                                 |
| KeyMarker ||| String | 列举分段上传任务的起始位置，与请求中的该参数对应。                           |
| UploadIdMarker ||| String | 列举分段上传任务的起始位置（UploadId标识），与请求中的该参数对应。               |
| NextKeyMarker ||| String | 下次列举分段上传任务请求的起始位置。                                  |
| NextUploadIdMarker ||| String | 下次列举分段上传任务请求的起始位置（UploadId标识），与NextKeyMarker配合使用。   |
| Delimiter ||| String | 用于对分段上传任务中的对象名进行分组的字符，与请求中的该参数对应。                   |
| Prefix   ||| String | 分段上传任务中的对象名前缀，与请求中的该参数对应。                           |
| MaxUploads ||| String | 列举分段上传任务的最大数目，与请求中的该参数对应。                           |
| IsTruncated ||| String | 表明本次请求是否返回了全部结果，"true"表示没有返回全部结果；"false"表示已返回了全部结果。 |
| Uploads  ||| Array  | 分段上传任务列表。                                           |
| - | Key   || String | 分段上传任务的对象名。                                         |
| - | UploadId || String | 分段上传任务的ID。                                          |
| - | Initiator || Object | 分段上传任务的创建者。                                         |
| - | - | ID | String | 创建者的DomainId。                                       |
| - | Owner || Object | 和Initiator相同，代表分段上传任务的创建者。                          |
| - | - | ID | String | 创建者的DomainId。                                       |
| - | Initiated || String | 分段上传任务的初始化时间。                                       |
| - | StorageClass || String | 分段上传对象的存储类型。                                        |
| CommonPrefixes ||| Array  | 当请求中设置了Delimiter分组字符时，返回按Delimiter分组后的对象名称前缀列表。     |
| - | Prefix || String | 按Delimiter分组后的对象名称前缀。                               |
   
#### 代码样例
```
obsClient.listMultipartUploads ({
       Bucket : 'bucketname',
       Prefix : 'prefix',
       MaxUploads : 100
},function (err, result) {
       if(err){
              console.error('Error-->' + err);
       }else{
              if(result.CommonMsg.Status < 300){
                     console.log('RequestId-->' + result.InterfaceResult.RequestId);
                     console.log('Bucket-->' + result.InterfaceResult.Bucket);
                     for(var i=0;i<result.InterfaceResult.Uploads.length;i++){
                           console.log('Uploads[' + i + ']');
                           console.log('UploadId-->' + result.InterfaceResult.Uploads[i]['UploadId']);
                           console.log('Key-->' + result.InterfaceResult.Uploads[i]['Key']);
                           console.log('Initiated-->' + result.InterfaceResult.Uploads[i]['Initiated']);
                           console.log('StorageClass-->' + result.InterfaceResult.Uploads[i]['StorageClass']);
                           console.log('Owner[ID]-->' + result.InterfaceResult.Uploads[i]['Owner']['ID']);
                           console.log('Initiator[ID]-->' + result.InterfaceResult.Uploads[i]['Initiator']['ID']);
                     }
              }else{
                     console.log('Code-->' + result.CommonMsg.Code);
                     console.log('Message-->' + result.CommonMsg.Message);
              }
       }
});
```