对象存储

  • 对象存储 > 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 实际资源名。

    响应状态码

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

    以上内容是否对您有帮助?
  • Qvm free helper
    Close