功能描述
APPEND Object 接口请求可以将一个对象以分块追加的方式上传至指定存储桶中。对象首次使用 APPEND Object 接口上传时，该对象的属性自动为 appendable ，使用其他接口上传时则属性自动为 normal （如果该对象已存在则属性会被覆盖为 normal），可以使用 GET Object 或 HEAD Object 接口获取 x-cos-object-type 响应头来判断对象属性。对象属性为 appendable 时才能使用本接口追加上传。
追加上传的对象，每个分块大小默认最大为5GB，无最小限制，同时通过追加方式产生的对象大小不得超过5GB。如果 Position 的值和当前对象的长度不一致，COS 将返回409错误。如果追加一个 normal 属性的文件，COS 将返回409 ObjectNotAppendable。
注意：
Appendable 的对象不可以被复制，不参与版本管理，不参与生命周期管理。
使用 APPEND 接口进行追加上传时，COS 不会校验请求携带的存储类型，仅会以当前对象的存储类型为准。
APPEND 接口不支持智能分层存储类型。
开启了多 AZ 特性的存储桶，不支持使用 APPEND Object 接口。
请求
请求示例
POST /ObjectName?append&position=*position* HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comContent-Length: sizeContent-Type: ContentTypeDate: GMT DateAuthorization: Auth String
说明：
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com，其中 <BucketName-APPID> 为带 APPID 后缀的存储桶名字，例如 examplebucket-1250000000，可参见 存储桶概览 > 基本信息 和 存储桶概述 > 存储桶命名规范 文档；<Region> 为 COS 的可用地域，可参见 地域和访问域名 文档。
Authorization: Auth String（详情请参见 请求签名 文档）。
请求头
公共头部
非公共头部
必选头部
该请求操作的实现使用如下必选头部：
名称 | 描述 | 类型 | 是否必选 |
Content-Length | RFC 2616 中定义的 HTTP 请求内容长度（字节） | String | 是 |
推荐头部
该请求操作的实现使用如下推荐请求头部信息：
节点名称（关键字） | 描述 | 类型 | 是否必选 |
Cache-Control | RFC 2616 中定义的缓存策略，将作为 Object 元数据返回 | String | 否 |
Content-Disposition | RFC 2616 中定义的文件名称，将作为 Object 元数据返回 | String | 否 |
Content-Encoding | RFC 2616 中定义的编码格式，将作为 Object 元数据返回 | String | 否 |
Content-MD5 | RFC 1864中定义的请求体内容的16字节二进制 MD5 哈希值的 Base64 编码形式，用于完整性检查，验证请求体在传输过程中是否发生变化，最终的取值长度应为24个字符，请注意在编写代码时使用正确的方法和参数，例如 ZzD3iDJdrMAAb00lgLLeig== | String | 否 |
Content-Type | RFC 2616 中定义的内容类型（MIME），将作为 Object 元数据返回 | String | 否 |
Expect | 当使用 Expect: 100-continue 时，在收到服务端确认后，才会发送请求内容 | String | 否 |
Expires | RFC 2616 中定义的过期时间，将作为 Object 元数据返回 | String | 否 |
x-cos-meta- * | 允许用户自定义的头部信息，将作为 Object 元数据返回，大小限制2K | String | 否 |
权限相关头部
该请求操作的实现可以用 POST 请求中的 x-cos-acl 头来设置文件访问权限。目前 Object 访问权限有三种：public-read-write，public-read 和 private。如果不设置，默认为 private 权限。也可以单独明确赋予用户读、写或读写权限。内容如下：
说明：
名称 | 描述 | 类型 | 是否必选 |
x-cos-acl | 定义 Object 的 ACL 属性，有效值为 private，public-read-write，public-read 默认值为 private | String | 否 |
x-cos-grant-read | 赋予被授权者读的权限，格式： x-cos-grant-read: id=" ",id=" "当需要给子账号授权时， id="qcs::cam::uin/<OwnerUin>:uin/<SubUin>"当需要给主账号授权时， id="qcs::cam::uin/<OwnerUin>:uin/<OwnerUin>" | String | 否 |
x-cos-grant-write | 赋予被授权者写的权限，格式： x-cos-grant-write: id=" ",id=" "当需要给子账号授权时， id="qcs::cam::uin/<OwnerUin>:uin/<SubUin>"当需要给主账号授权时， id="qcs::cam::uin/<OwnerUin>:uin/<OwnerUin>" | String | 否 |
x-cos-grant-full-control | 赋予被授权者读写权限，格式： x-cos-grant-full-control: id=" ",id=" "当需要给子账号授权时， id="qcs::cam::uin/<OwnerUin>:uin/<SubUin>"当需要给主账号授权时， id="qcs::cam::uin/<OwnerUin>:uin/<OwnerUin>" | String | 否 |
请求参数
具体内容如下：
参数名称 | 描述 | 类型 | 是否必选 |
position | 追加操作的起始点，单位为字节。首次追加则设置 Position=0，后续追加则设置 Position 为当前 Object 的 content-length | Int | 是 |
请求体
该请求的请求体为空。
响应
响应头
公共响应头
特有响应头
该请求操作的响应头具体数据为：
节点名称（关键字） | 描述 | 类型 |
x-cos-next-append-position | 下一次追加操作的起始点，单位：字节 | String |
ETag | 文件的唯一标识 | String |
响应体
该响应体返回为空。
错误分析
如果对一个非 appendable 的文件进行 APPEND 操作，那么会返回409 Conflict，错误信息：
The operation is not valid for the current state of the object。
如果请求中未携带 position 参数，会返回400 Bad Request，错误信息：InvalidArgument。
如果请求中缺失 Content-Length 头部，会返回 411 Length Required，错误信息：
You must provide the Content-Length HTTP header。
实际案例
请求
POST /coss3/app?append&position=0 HTTP/1.1Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.comDate: Tue, 16 Jan 2016 21:32:00 GMTAuthorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1484208848;32557104848&q-key-time=1484208848;32557104848&q-header-list=host&q-url-param-list=append;position&q-signature=****************************************Content-Length: 4096[Object]
响应
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 0Connection: keep-aliveDate: Tue, 16 Jan 2016 21:32:00 GMTETag: 1ce5b469b7d6600ecc2fd112e570917bServer: tencent-cosx-cos-content-sha1: 1ceaf73df40e531df3bfb26b4fb7cd95fb7bff1dx-cos-next-append-position: 4096x-cos-request-id: NTg3NzNhZGZfMmM4OGY3X2I2Zl8x****
