![]()
描述
将上传好的所有数据块按指定顺序合并成一个资源文件。
![]()
请求
POST /mkfile/<fileSize>/key/<encodedKey>/fname/<encodedFname>/mimeType/<encodedMimeType>/x:user-var/<encodedUserVars> HTTP/1.1
Host: <UpHost>
Content-Type: text/plain
Content-Length: <ctxListSize>
Authorization: UpToken <UploadToken>
<lastCtxOfBlock1,lastCtxOfBlock2,lastCtxOfBlock3,...,lastCtxOfBlockN>
使用说明：
可以复用创建块时使用的上传凭证。
上传凭证将被重新验证，若已过期，可以使用重新生成的凭证。
若参数中指定了资源名，而所用上传策略的scope字段中也指定了资源名，且两者不一致，操作将失败且返回 401 状态码。
若参数与上传策略scope字段中未指定资源名，则需要使用insertOnly字段，才能达到同名文件上传不被覆盖效果。
| 参数名称 | 必填 | 类型 | 说明 |
|---|
| fileSize | 是 | int64 | 资源文件大小，单位字节。 |
| encodedKey |
| string | 进行URL 安全的 Base64 编码后的资源名。若未指定，则使用saveKey；若未指定 saveKey，则使用资源内容的 SHA1 值作为资源名。 |
| encodedFname |
| string | 进行URL安全的Base64编码后的文件名称。 |
| encodedMimeType |
| string | 进行URL 安全的 Base64 编码后的文件 mimeType。 |
| encodedUserVars |
| string | 指定自定义变量，进行URL 安全的 Base64 编码后的 user-var |
| 头部名称 | 必填 | 说明 |
|---|
| Host | 是 | 上传服务器域名。
上传到华东区的域名为up.qiniup.com、up-z0.qiniup.com和upload.qiniup.com
上传到华北区的域名为up-z1.qiniup.com和upload-z1.qiniup.com
后续片的上传为上一次上传响应返回的后续上传接收地址 |
| Content-Type | 是 | 固定为text/plain。 |
| Content-Length | 是 | 所有块的 ctx 及分隔符的总长度，单位为字节。 |
| Authorization | 是 | 该参数应严格按照上传凭证格式进行填充，否则会返回 401 错误码。一个合法的 Authorization 值应类似于Authorization: UpToken QNJi_bYJlmO5LeY08FfoNj9w_r…。 |
| 参数名称 | 必填 | 说明 |
|---|
| lastCtxOfBlock | 是 | 每个数据块最后一个数据片上传后得到的 ctx |
![]()
响应
该请求操作的实现使用了所有操作的公共响应头。
| 名称 | 说明 |
|---|
| hash | 资源内容的 SHA1 值。 |
| key | 实际资源名。 |
