对象存储

  • 对象存储 > API 文档 > Object 接口 > 追加文件

    追加文件

    最近更新时间: 2022-06-09 16:05:14

    描述

    追加指定文件的数据,具体数据量可根据现场环境调整。(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,并再次进行请求。

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