
# 合并段
#### 功能说明
通过分段上传任务的ID，合并指定桶中已上传的段。
#### 方法定义
```
ObsClient.completeMultipartUpload
```
#### 请求参数
| **字段名**       || **类型**                                                                      | **约束** | **说明**                                                                                                  |
|:--|---|:---|:---|:---|
| Bucket        || String                                                                      | 必选     | 桶名。                                                                                                     |
| Key           || String                                                                      | 必选     | 对象名。                                                                                                    |
| RequestDate   || String 或 Date | 可选     | 指定请求时间。 说明： 当为String类型时，必须符合ISO8601或RFC822规范。 |
| UploadId      || String                                                                      | 必选     | 分段上传任务的ID。                                                                                              |
| Parts         || Array                                                                       | 必选     | 合并的段列表。                                                                                                 |
| - | PartNumber | String                                                                      | 必选     | 段号。                                                                                                     |
| - | ETag       | String                                                                      | 必选     | 段的ETag值。                                                                                                |
   
#### 返回结果（InterfaceResult）
| **字段名**   | **类型** | **说明**                 |
|:---|:---|:---|
| RequestId | String | OBS服务端返回的请求ID。         |
| ETag      | String | 合并段后根据各个段的ETag值计算出的结果。 |
| Bucket    | String | 合并段所在的桶。               |
| Key       | String | 合并段后得到的对象名。            |
| Location  | String | 合并段后得到的对象的url。         |
| VersionId | String | 合并段后得到的对象版本号。          |
   
#### 代码样例
```
obsClient.completeMultipartUpload({
       Bucket:'bucketname',
       Key : 'objectkey',
       UploadId : 'uploadid',
       Parts : [{PartNumber : 1, ETag : 'etag1'}, {PartNumber : 2, ETag : 'etag2'}]
},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('Location-->' + result.InterfaceResult.Location);
              }else{
                     console.log('Code-->' + result.CommonMsg.Code);
                     console.log('Message-->' + result.CommonMsg.Message);
              }
       }
});
```
