追加上传

描述

追加上传接口支持用户通过追加的方式在一个object后面直接追加内容的功能，每次追加上传的数据都能够即时可读。通过这种方式操作的object为Appendable Object。

请求说明

Token的计算，上传策略的定义和跟普通上传接口保持一致。每次append操作按照普通上传的上传策略完成。
请求样式

POST /append/<position>
Host: <UploadDomain>
Content-Length:<appendSize>
Content-Type: multipart/form-data; boundary=<boundary>
--<boundary>
Content-Disposition: form-data; name="token"
<uploadToken>
--<boundary>
Content-Disposition:       form-data; name="<x:VariableName>"
<x:VariableValue>
--<boundary>
Content-Disposition: form-data; name="key"
<key>
--<boundary>
Content-Disposition: form-data; name="mimeType"
<mimeType>
--<boundary>
Content-Disposition: form-data; name="deadline"
<deadline>
--<boundary>
Content-Disposition: form-data; name="file"; filename="原文件名"
Content-Type: application/octet-stream
<fileBinaryData>
--<boundary>--

请求消息参数

请求头部

表单说明

响应说明

响应样式

HTTP/1.1 status_code
x-wcs-next-append-position:object size
x-wcs-object-type:Appendable
Server: WS-web-server
<ResponseContent>

响应消息头

响应消息体

如果请求成功，为如下内容的URL安全的Base64编码字符串：

hash=<filehash>

注：如果上传时定义了returnBody，则返回内容中会增加returnBody的内容，如 name=&size=hash= 。

如果请求失败，为如下内容的Json字符串：

{
    "code":     "<code string>",
    "message":  "<message string>"
}

细节分析

1. URL参数必须包含append，用来指定这是一个追加操作。
2. URL参数必须包含position，其值指定从何处进行追加。首次追加操作的position必须为0，后续追加操作的position必须是Object的当前长度，否则返回409，错误码PositionNotEqualToLength。发生上述错误时，用户可以通过响应头部x-wcs-next-append-position来得到下一次position，并再次进行请求。
3. 当position为0，如果没有同名appendable object，或者同名appendable object长度为0，则该请求成功，其他情况都认为是PositionNotEqualToLength。
4. 每次append object的长度不能超过2G，每次append object都会更新object的最后修改时间。
5. 在position值正确的情况下，对已存在的appendable object追加一个长度为0的内容，该操作成功，不会改变object的状态。
6. 追加操作时不允许并发追加一个对象。
7. 追加操作要求对操作Object要有写权限。

范例

curl -v -i -X POST -H "Expect:" -F file=@D:/8.png -F key=m.png -F token="6a69ab4062cb03059e4c13a0f5e662523effad49:ZGE1MWY1YzA4ZDgyMjVlM2Q3MmE2YjZkZDI3MmY1ZmMxNjk2YTFjOA==:eyJzY29wZSI6InRlc3QiLCJkZWFkbGluZSI6IjE0NzIxNzY2MzQwMDAiLCJvdmVyd3JpdGUiOjAsImZzaXplTGltaXQiOjAsImluc3RhbnQiOjAsInNlcGFyYXRlIjowfQ=="  --url http://uploaddomain.com/append/0