完成整个文件的分片上传

POST

/v4/oss/complete-multipart-upload

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

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

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

请求参数

Authorization

在 header 添加参数

userID

示例：

userID: ********************

Header 参数

Body 参数application/json

示例

{
    "regionID": "nm8",
    "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

curl --location --request POST 'http://ct-global.ctapi-internal.ctyun.local:31111/v4/oss/complete-multipart-upload' \
--header 'x-ctyun-user-id: {{userID}}' \
--header 'Accept-Language: zh-CN' \
--header 'userId: ef378f73-1c52-435e-90f2-6a9cd2258c8e' \
--header 'userID: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "nm8",
    "bucket": "ztces-230404-create",
    "key": "ces3.txt",
    "uploadId": "2~MJGKGlymWrfe36O99u6BroF3u3-bdRU",
    "multipartUpload": {
        "parts": [
            {
                "ETag": "\"202cb962ac59075b964b07152d234b70\"",
                "partNumber": 1
            }
        ]
    }
}'

返回响应

🟢200successful operation

application/json

Body

示例

成功示例成功示例

{
	"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
}

修改于 2025-08-07 08:26:25

根据指定的Object名和uploadId来分块（Part）上传数据

从一个已存在的Object中拷贝数据来上传一个Part