目录

合并分片

功能介绍

此接口用于将已经上传成功后的分片合并为一个文件。

接口原型

承载协议

HTTPS POST

接口方向

服务商服务器 -> 华为服务器

接口URL

https://connect-api.cloud.huawei.com/api/publish/v2/upload/multipart/compose

数据格式

请求：Content-Type: application/json

响应：Content-Type: application/json

请求参数

[h2]Header

参数名称

必选(M)/可选(O)

类型

参数说明

client_id

M

String

API客户端ID。

创建第三方平台成功后系统自动分配的客户端ID，可在第三方管理平台“开发配置 > 开发资料设置”页面中获取，详情请参见接口访问凭证（平台访问凭据）。

Authorization

M

String

认证信息，格式为“Authorization: Bearer ${access_token}”。access_token为获取平台级Token中获取的access_token。

[h2]Query

参数名称

必选(M)/可选(O)

类型

参数说明

objectId

M

String(200)

对象ID，参见分片上传初始化时生成的objectId参数。

nspUploadId

M

String(64)

上传ID，参见分片上传初始化时生成的nspUploadId参数。

[h2]Body

请求Body中使用JSON格式携带分片信息，参数如下所示。

参数名称

必选(M)/可选(O)

类型

参数说明

additionalPropX

M

FilePartComposeInfo

分片信息。

其中参数名中的X为分片的编号，例如additionalProp1、additionalProp2，需要与获取分片上传地址时返回的分片编号一致。

FilePartComposeInfo

参数名称

必选(M)/可选(O)

类型

参数说明

partObjectId

M

String(64)

分段对象ID，必须与获取分片上传地址时返回的partObjectId一致。

etag

M

String(64)

上传分片实体时返回的分片的Etag值。

请求示例

POST /api/publish/v2/upload/multipart/compose?objectId=*******&nspUploadId=***** HTTP/1.1
Host: connect-api.cloud.huawei.com
client_id: 41******68
Content-Type: application/json
Authorization: Bearer ******
{
    "additionalProp1": {
        "partObjectId": "",
        "etag": "41a9ba6******fac180e149f94"
    },
    "additionalProp2": {
        "partObjectId": "",
        "etag": "2b8dd6a26*****3a364f55d2a92"
    }
}

响应参数

参数名称

必选(M)/可选(O)

类型

参数说明

ret

M

ConnectRet

包含返回码及描述信息的结果。

ConnectRet

参数名称

必选(M)/可选(O)

类型

参数说明

code

O

Integer

返回码，请参见错误码。

msg

O

String

返回码描述信息。