描述
追加指定文件的数据,具体数据量可根据现场环境调整。
请求
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
参数名称 | 必填 | 类型 | 说明 |
---|
/offset | 是 | int64 | 追加文件的偏移量 |
/Fsize | 否 | int64 | 文件大小,支持传入 -1 表示文件大小以 http request body 为准。 |
/EncodedKey | 是 | string | EncodedKey 需要经过 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 |