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

POST

/v4/oss/action-multipart-upload

该接口用于实现分片上传操作中片段的上传。

在上传任何一个分片之前，必须执行Initial Multipart Upload操作来初始化分片上传操作，初始化成功后，OOS会返回一个上传ID，这是一个唯一的标识，用户必须在调用Upload Part接口时加入该ID。

分片号PartNumber可以唯一标识一个片段并且定义该分片在对象中的位置，范围从1到10000。如果用户用之前上传过的片段的分片号来上传新的分片，之前的分片将会被覆盖。

除了最后一个分片外，所有分片的都不小于5M，最后一个分片的大小不受限制。

为了确保数据不会由于网络传输而毁坏，需要在每个分片上传请求中指定Content-MD5头，OOS通过提供的Content-MD5值来检查数据的完整性，如果不匹配，则会返回一个错误信息。

与V1暂未对齐，V1中body使用string类型，V2使用文件流上传[form-data格式]

请求参数

Authorization

在 header 添加参数

userID

示例：

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

Header 参数

Body 参数multipart/form-data

请求示例代码

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/action-multipart-upload' \
--header 'x-ctyun-user-id: {{userID}}' \
--header 'Accept-Language: zh-CN' \
--header 'userId: ef378f73-1c52-435e-90f2-6a9cd2258c8e' \
--header 'userID: <api-key>' \
--form 'regionID="nm8"' \
--form 'bucket="bucket01"' \
--form 'key="file/a.txt"' \
--form 'uploadID="2~wcY8SoR-oofC_3UiVE_CkGSgNSsOpCr"' \
--form 'partNumber="1"' \
--form 'body=@""'

返回响应

🟢200successful operation

application/json

Body

示例

{
	"description":"成功",
	"errorCode":"SUCCESS",
	"message":"success",
	"returnObj":[
		{
			"bucket":"ztces-230404-create",
			"eTag":"\"202cb962ac59075b964b07152d234b70\""
		}
	],
	"statusCode":800
}

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

通知OSS初始化一个Multipart Upload事件

完成整个文件的分片上传