完成整个文件的分片上传

接口通过合并之前的上传片段来完成一次分片上传过程。

用户首先初始化分片上传过程，然后通过Upload Part接口上传所有分片。在成功将一次分片上传过程的所有相关片段上传之后，调用这个接口来结束分片上传过程。当收到这个请求的时候，OOS会以分片号升序排列的方式将所有片段依次拼接来创建一个新的对象。在这个Complete Multipart Upload请求中，用户需要提供一个片段列表。同时，必须确保这个片段列表中的所有片段必须是已经上传完成的，Complete Multipart Upload操作会将片段列表中提供的片段拼接起来。对片段列表中的每个片段，需要提供该片段上传完成时返回的ETag头的值和对应的分片号。

OOS提供了不合并片段也可以读取Object内容的功能。在没有调用Complete Multipart Upload接口合并片段时，也可以通过调用Get Object接口来获取文件内容，OOS会根据最近一次创建的uploadId，以分片号升序的方式顺序读取片段内容，返回给客户端。

请求参数

Body 参数application/json

regionID

string

资源池id

必需

bucket

string

桶名称

必需

key

string

文件key

必需

uploadID

string

分段上传的ID

必需

multipartUpload

object

必需

所有成功上传的分段的分段信息

parts

array [object {6}]

分段信息

必需

示例

{
    "regionID": "TestRegionID",
    "bucket": "ztces-230404-create",
    "key": "ces3.txt",
    "uploadId": "2~MJGKGlymWrfe36O99u6BroF3u3-bdRU",
    "multipartUpload": {
        "parts": [
            {
                "ETag": "\"202cb962ac59075b964b07152d234b70\"",
                "partNumber": 1
            }
        ]
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200successful operation

application/json

Body

description

string

描述

可选

errorCode

string

错误码

可选

message

string

错误说明

可选

returnObj

object

响应对象

可选

ETag

string

ETag

可选

key

string

对象名

可选

bucket

string

存储空间

可选

location

string

上传的对象位置

可选

versionID

string

可选

versionID，开启了多版本时会返回

statusCode

integer <int32>

请求状态码

可选

示例

{
    "description": "成功",
    "errorCode": "SUCCESS",
    "message": "success",
    "returnObj": {
        "ETag": "d022646351048ac0ba397d12dfafa304-1",
        "bucket": "ztces-230404-create",
        "key": "ces3.txt",
        "location": "http://10.246.117.22:25989/ztces-230404-create/ces3.txt",
        "versionID": "Y7jaqHY7rfvsG3zkEZnZcEIsDngKyZ9"
    },
    "statusCode": 800
}