创建文件

• 描述
• 请求
  • 请求语法
  • 请求参数
  • 头部信息
  • 请求内容
    
  • 访问权限
• 响应
  • 头部信息
  • 响应内容
  • 响应状态码
• 附注
• 内部参考资源

描述

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

请求

请求语法

POST /mkfile/<fileSize>/key/<encodedKey>/mimeType/<encodedMimeType>/x:user-var/<encodedUserVars> HTTP/1.1
Host:           <UpHost>
Content-Type:   text/plain
Content-Length: <ctxListSize>
Authorization:  UpToken <UploadToken>

<ctxList>

请求参数

头部信息

请求内容

该请求的内容为每个数据块最后一个数据片上传后得到的<ctx>的列表，以“,”分隔，按其在源文件中的位置排序。
注意：列表最后一项后面不需要添加“,”。

<lastCtxOfBlock1>,<lastCtxOfBlock2>,<lastCtxOfBlock3>,...,<lastCtxOfBlockN>

访问权限

上传凭证方式。

响应

头部信息

其它可能返回的头部信息，请参考HTTP响应扩展字段。

响应内容

■ 如果请求成功，返回包含如下内容的JSON字符串（已格式化，便于阅读）：

{
    "hash": "<ContentHash  string>", 
    "key":  "<Key          string>"
}

■ 如果请求失败，返回包含如下内容的JSON字符串（已格式化，便于阅读）：

{
    "code":     <HttpCode  int>, 
    "error":   "<ErrMsg    string>"
}

响应状态码

附注

• 可以复用创建块时使用的上传凭证。
  
• 上传凭证将被重新验证，若已过期，可以使用重新生成的凭证。
  
• 若参数中指定了资源名，而所用上传策略的scope字段中也指定了资源名，且两者不一致，操作将失败且返回401状态码。

内部参考资源

• 上传凭证
• 创建块
• 上传片
• URL安全的Base64编码