描述
追加指定文件的数据,具体数据量可根据现场环境调整。(2022-06-08 公有云已经禁用该 API )
请求
语法
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 可选
- 支持魔法变量,参考put_v2接口。
- 当offset 不为0时,忽略mimeType
请求参数
参数名称 | 必填 | 类型 | 说明 |
---|---|---|---|
/offset |
是 | int64 | 追加文件的偏移量 |
/Fsize |
否 | int64 | 文件大小,支持传入 -1 表示文件大小以 http request body 为准。 |
/EncodedKey |
是 | string | EncodedKey 需要经过 base64 编码。具体可以参照:URL 安全的 Base64 编码。 |
/<EncodedMimeType> |
否 | string | 文件的需要经过 base64 编码。具体可以参照:URL 安全的 Base64 编码。默认是 application/octet-stream,仅第一次调用append时有效,后续无法通过该接口修改。 |
/<Crc32> |
否 | string | 文件内容的 crc32 校验值,不指定则不进行校验。 |
请求头
头部名称 | 必填 | 说明 |
---|---|---|
Host | 是 | 上传域名。七牛对象存储支持的区域和对应区域上传域名列表见 存储区域列表 |
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 |
特殊错误
该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息,请查阅错误响应。
如果 position 的值和当前 Object 的长度不一致,会返回 409 错误,错误码为 invalid offset 。发生上述错误时,用户可以通过读取 nextAppendPosition 来得到下一次 position,并再次进行请求。
文档反馈
(如有产品使用问题,请 提交工单)