对象存储

  • 追加文件

    最近更新时间:2018-11-21 18:54:33

    描述

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


    请求



    语法

    POST /append/<offset>/fsize/<Fsize>/key/<EncodedKey>/mimeType/<EncodedMimeType>/crc32/<Crc32> HTTP/1.1
    Host: <Host>
    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 上传服务器域名。
  • 上传到华东区的域名为up.qiniup.comup-z0.qiniup.comupload.qiniup.com
  • 上传到华北区的域名为up-z1.qiniup.comupload-z1.qiniup.com
  • 上传到华南区的域名为up-z2.qiniup.comupload-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


    特殊错误

    该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息,请查阅错误响应
    如果position的值和当前Object的长度不一致,会返回409错误,错误码为invalid offset。发生上述错误时,用户可以通过读取nextAppendPosition来得到下一次position,并再次进行请求。

    以上内容是否对您有帮助?
  • Icon free helper
    Close