116
Object接口 > 追加文件

描述

追加指定文件的数据,具体数据量可根据现场环境调整。

请求

  • 语法
POST /append/<offset>/fsize/<Fsize>/key/<EncodedKey>/mimeType/<EncodedMimeType>/crc32/<Crc32> HTTP/1.1
Host: <UpHost>
Authorization: UpToken <UpToken>
Content-Type: application/octet-stream
Content-Length: <length>

<FileContent>
  • 使用说明

可以复用创建块时使用的上传凭证。

上传凭证将被重新验证,若已过期,可以使用重新生成的凭证。

MimeType, Crc32 可选

当offset 不为0时,忽略mimeType

  • 请求参数
参数名称必填类型说明
/offsetint64追加文件的偏移量
/Fsizeint64文件大小,支持传入 -1 表示文件大小以 http request body 为准。
/EncodedKeystringEncodedKey 需要经过 base64 编码。
/<EncodedMimeType>string文件的需要经过 base64 编码。默认是 application/octet-stream,仅第一次调用append时有效,后续无法通过该接口修改。
/<Crc32>string文件内容的 crc32 校验值,不指定则不进行校验。
  • 请求头
头部名称必填说明
Host上传服务器域名。
上传到华东区的域名为up.qiniup.com、up-z0.qiniup.com和upload.qiniup.com
上传到华北区的域名为up-z1.qiniup.com和upload-z1.qiniup.com
上传到华南区的域名为up-z2.qiniup.com和upload-z2.qiniup.com
后续片的上传为上一次上传响应返回的后续上传接收地址
Content-Type固定为application/octet-stream。
Content-Length当前片的内容长度,单位为字节。
Authorization该参数应严格按照上传凭证格式进行填充,否则会返回 401 错误码。一个合法的 Authorization 值应类似于Authorization: UpToken QNJi_bYJlmO5LeY08FfoNj9w_r…。
  • 请求元素
参数名称必填说明
FileContent当前片的二进制内容

响应

  • 响应头

该请求操作的实现使用了所有操作的公共响应头。

名称说明
nextAppendPosition接下来的 Append 位置。Type:uint64。
etag目标资源的hash值,可用于 ETag 头部。Type:string

这条帮助是否解决了您的问题? 已解决 未解决

提交成功!非常感谢您的反馈,我们会继续努力做到更好! 很抱歉未能解决您的疑问。我们已收到您的反馈意见,同时会及时作出反馈处理!