对象存储 > API 文档 > Object 接口 > 分片上传 v1 版 > 创建文件

创建文件

最近更新时间: 2021-11-15 18:00:02

描述

将上传好的所有数据块按指定顺序合并成一个资源文件。

请求

请求语法

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编码后的文件名称。若未指定，则魔法变量中无法使用fname, ext, fprefix。
encodedMimeType		string	进行URL 安全的 Base64 编码后的文件 mimeType。若未指定，则根据文件内容自动检测 mimeType。
encodedUserVars		string	指定自定义变量，进行URL 安全的 Base64 编码后的 user-var。

请求头

头部名称	必填	说明
Host	是	上传域名。七牛对象存储支持的区域和对应区域上传域名列表见存储区域列表后续片的上传为上一次上传响应返回的后续上传接收地址
Content-Type	是	固定为`text/plain`。
Content-Length	是	所有块的 ctx 及分隔符的总长度，单位为字节。
Authorization	是	该参数应严格按照上传凭证格式进行填充，否则会返回 401 错误码。一个合法的 Authorization 值应类似于`Authorization: UpToken QNJi_bYJlmO5LeY08FfoNj9w_r...`。

请求内容

参数名称	必填	说明
lastCtxOfBlock	是	每个数据块最后一个数据片上传后得到的 ctx

响应

响应头

该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅公共响应头。

响应内容

名称	说明
hash	资源内容的 SHA1 值。
key	实际资源名。

响应状态码

该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅错误响应。

以上内容是否对您有帮助？