接口介绍
完成分段上传。
接口约束
-
支持的线上资源池 ：上海7、南京3、南京5、杭州2、合肥2、九江、广州6、武汉4、福州25、厦门3、郴州2、海口2、北京5、雄安2、石家庄20、内蒙6、晋中、辽阳1、西安5、乌鲁木齐4、乌鲁木齐27、中卫5、兰州2、西宁2、拉萨3、昆明2、重庆2、成都4、贵州3、上海33、宁波边缘云、华东1、上海36、南昌5、青岛20、武汉41、长沙42、长沙37、南宁23、北京行业云20、华北2、西南1、上海32。
-
上传的分段必须至少为 5 MB，最后一个分段除外，否则无法完成分段上传。
-
必须保证 parts 内的所有分段信息存在并匹配。
-
若分段上传已中止或已完成，则会失败。
URI
POST /v4/oss/complete-multipart-upload
请求参数
请求体 JSON Body 参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名 | bucket1 |
| key | 是 | String | 对象名称 | obj1 |
| regionID | 是 | String | 区域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
| multipartUpload | 是 | Object | 分段上传相关信息 | 见下级对象 |
| uploadID | 是 | String | 分段上传的ID | 2~3BRpGICgM_5Lym31H53HhYl-XD6vjeH |
表 multipartUpload
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| parts | 是 | Array of Objects | 分段信息 | 见下级对象 |
表 parts
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| partNumber | 是 | Integer | 分段编号 | 1 |
| ETag | 是 | String | ETag | 5f363e0e58a95f06cbe9bbc662c5dfb6 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 |
|---|---|---|---|
| returnObj | Object | 响应对象 | 见下级对象 |
| statusCode | Integer | 返回码 取值范围：800 成功 |
800 |
| message | String | 状态描述 | SUCCESS |
| description | String | 状态描述，一般为中文 | 成功 |
| errorCode | String | 业务细分码（仅失败时具有此参数），为product.module.code三段式码 | openapi.userPermission.accessFailed |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 |
|---|---|---|---|
| ETag | String | ETag | xxx |
| key | String | 对象名 | obj1 |
| bucket | String | 桶 | bucket1 |
| versionID | String | 版本ID，在开启多版本时可使用 | difughdifgfnguyubvfer |
| location | String | 上传的对象位置 | https://examplebucket.s3.amazonaws.com/bigobject |
请求示例
{
"bucket": "bucket1",
"regionID": "332232eb-63aa-465e-9028-52e5123866f0",
"key": "obj1",
"multipartUpload": {
"parts": [
{
"ETag": "5f363e0e58a95f06cbe9bbc662c5dfb6",
"partNumber": 1
},
{
"ETag": "34ae08b4a695b10f23d94913cb881c6c",
"partNumber": 2
}
]
},
"uploadID": "2~3BRpGICgM_5Lym31H53HhYl-XD6vjeH"
}
响应示例
{
"returnObj": {
"ETag": "xxx",
"key": "obj1",
"bucket": "bucket1",
"location": "https://examplebucket.s3.amazonaws.com/bigobject"
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
| 状态码 | 描述 |
|---|---|
| 800 | 表示请求成功。 |
| 900 | 表示请求失败。 |
错误码
errorCode 枚举值，见错误码总表
