# 列举已上传的段
#### 功能说明
通过分段上传任务的ID，列举指定桶中已上传的段。
#### 方法定义
```
ObsClient.listParts
```
#### 请求参数
| **字段名**          | **类型**                                                                      | **约束** | **说明**                                                                                                  |
|:---|:---|:---|:---|
| Bucket           | String                                                                      | 必选     | 桶名。                                                                                                     |
| Key              | String                                                                      | 必选     | 对象名。                                                                                                    |
| RequestDate      | String 或 Date | 可选     | 指定请求时间。 说明： 当为String类型时，必须符合ISO8601或RFC822规范。 |
| UploadId         | String                                                                      | 必选     | 分段上传任务的ID。                                                                                              |
| MaxParts         | Number                                                                      | 可选     | 列举已上传段的返回结果最大段数目，即分页时每一页中段数目。                                                                           |
| PartNumberMarker | Number                                                                      | 可选     | 列举已上传段的起始位置，只有Part Number大于该参数的段会被列出。                                                                   |
   
#### 返回结果（InterfaceResult）
| **字段名**         || **类型** | **说明**                                              |
|:--|---|:---|:---|
| RequestId       || String | OBS服务端返回的请求ID。                                      |
| Bucket          || String | 桶名。                                                 |
| Key             || String | 对象名。                                                |
| UploadId        || String | 分段上传任务的ID。                                          |
| PartNumberMarker || String | 列举已上传段的起始位置，与请求中的该参数对应。                             |
| NextPartNumberMarker || String | 下次列举已上传段请求的起始位置。                                    |
| MaxParts        || String | 列举已上传段的返回结果最大段数目，与请求中的该参数对应。                        |
| IsTruncated     || String | 表明本次请求是否返回了全部结果，"true"表示没有返回全部结果；"false"表示已返回了全部结果。 |
| Parts           || Array  | 已上传段列表。                                             |
| - | PartNumber   | String | 段号。                                                 |
| - | LastModified | String | 段的最后上传时间。                                           |
| - | ETag         | String | 段的ETag值。                                            |
| - | Size         | String | 段的大小。                                               |
| Initiator       || Object | 分段上传任务的创建者。                                         |
| - | ID           | String | 创建者的DomainId。                                       |
| Owner           || Object | 和Initiator相同，代表分段上传任务的创建者。                          |
| - | ID           | String | 创建者的DomainId。                                       |
| StorageClass    || String | 待分段上传对象的存储类型。                                       |
   
#### 代码样例
```
obsClient.listParts({
       Bucket:'bucketname',
       Key : 'objectkey',
       UploadId : 'uploadid',
       MaxParts : 10
},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);
                     console.log('Key-->' + result.InterfaceResult.Key);
                     console.log('UploadId-->' + result.InterfaceResult.UploadId);
                     console.log('PartNumberMarker-->' + result.InterfaceResult.PartNumberMarker);
                     console.log('NextPartNumberMarker-->' + result.InterfaceResult.NextPartNumberMarker);
                     console.log('MaxParts-->' + result.InterfaceResult.MaxParts);
                     console.log('IsTruncated-->' + result.InterfaceResult.IsTruncated);
                     console.log('StorageClass-->' + result.InterfaceResult.StorageClass);
                     console.log('Initiator[ID]-->' + result.InterfaceResult.Initiator['ID']);  
                     console.log('Owner[ID]-->' + result.InterfaceResult.Owner['ID']);
                     for(var i=0;i<result.InterfaceResult.Parts.length;i++){
                           console.log('Part['+i+']:');
                           console.log('PartNumber-->' + result.InterfaceResult.Parts[i]['PartNumber']);
                           console.log('LastModified-->' + result.InterfaceResult.Parts[i]['LastModified']);
                           console.log('ETag-->' + result.InterfaceResult.Parts[i]['ETag']);
                           console.log('Size-->' + result.InterfaceResult.Parts[i]['Size']);
                     }
              }else{
                     console.log('Code-->' + result.CommonMsg.Code);
                     console.log('Message-->' + result.CommonMsg.Message);
              }
       }
});
```