AppendObject
AppendObject接口用于以追加写的方式上传文件(Object)。通过AppendObject操作创建的Object类型为Appendable Object,而通过PutObject上传的Object是Normal Object。
使用限制
- AppendObject产生的Object大小不得超过5 GB。
- 处于WORM保护期的Object不支持AppendObject操作。
- AppendableObject不支持指定CMK ID进行服务端KMS加密。
请求语法
POST /ObjectName?append&position=Position HTTP/1.1
Content-Length:ContentLength
Content-Type: ContentType
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
请求头
名称 | 类型 | 是否必选 | 描述 |
---|---|---|---|
Append | 字符串 | 是 |
用于指定这是一个AppendObject操作。 |
Position | 字符串 | 是 |
用于指定从何处进行追加。 首次追加操作的position必须为0,后续追加操作的position是Object的当前大小。例如,第一次AppendObject请求指定position值为0,content-length是65536,则第二次AppendObject需要指定position为65536。 每次操作成功后,响应消息头x-oss-next-append-position也会标明下一次追加的position。 说明
|
Cache-Control | 字符串 | 否 |
指定该Object的网页缓存行为。详情参考RFC2616。 默认值:无 |
Content-Disposition | 字符串 | 否 |
指定该Object被下载时的名称。详情参考RFC2616。 默认值:无 |
Content-Encoding | 字符串 | 否 |
指定该Object的内容编码格式。详情参考RFC2616。 默认值:无 |
Content-MD5 | 字符串 | 否 |
Content-MD5是一串由MD5算法生成的值,该请求头用于检查消息内容是否与发送时一致。 获取Content-MD5值:对消息内容(不包括头部)执行MD5算法获得128比特位数字,然后对该数字进行base64编码。 默认值:无 限制:无 |
Expires | GMT | 否 |
过期时间。详情参考RFC2616。 默认值:无 |
x-oss-server-side-encryption | 字符串 | 否 |
指定服务器端加密编码算法。 合法值:AES256 或 KMS 说明 您需要购买KMS套件,才可以使用KMS加密算法,否则会返回KmsServiceNotEnabled。
|
x-oss-object-acl | 字符串 | 否 |
指定Object的访问权限。 合法值:public-read、private、public-read-write |
x-oss-storage-class | 字符串 | 否 |
指定Object的存储类型。 取值:Standard、IA、Archive 支持的接口:PutObject、InitMultipartUpload、AppendObject、 PutObjectSymlink、CopyObject。 说明
|
- 使用AppendObject接口时,如果配置以x-oss-meta-*为前缀的参数,则该参数视为元数据,例如x-oss-meta-location。一个Object可以有多个类似的参数,但所有的元数据总大小不能超过8KB。元数据支持短横线(-)、数字、英文字母(a-z),英文字符的大写字母会被转成小写字母,不支持下划线(_)在内的其他字符。
- 创建AppendObject时可以添加x-oss-meta-*,继续追加时不可以携带此参数。
响应头
响应消息头 | 类型 | 描述 |
---|---|---|
x-oss-next-append-position | 64位整型 |
下一次请求应当提供的position,即当前Object大小。 当AppendObject执行成功,或是因position和Object大小不匹配而引起的409错误时,会返回此消息头。 |
x-oss-hash-crc64ecma | 64位整型 |
表明Object的64位CRC值。该64位CRC由ECMA-182标准计算得出。 |
CRC64的计算方式
Appendable Object的CRC采用ECMA-182标准。您可以使用以下方法进行计算:
用Boost CRC模块的方式计算
typedef boost::crc_optimal<64, 0x42F0E1EBA9EA3693ULL, 0xffffffffffffffffULL, 0xffffffffffffffffULL, true, true> boost_ecma;
uint64_t do_boost_crc(const char* buffer, int length)
{
boost_ecma crc;
crc.process_bytes(buffer, length);
return crc.checksum();
}
用Python crcmod的方式计算
do_crc64 = crcmod.mkCrcFun(0x142F0E1EBA9EA3693L, initCrc=0L, xorOut=0xffffffffffffffffL, rev=True)
print do_crc64(“123456789”)
示例
- 请求示例
POST /oss.jpg?append&position=0 HTTP/1.1 Host: oss-example.oss.aliyuncs.com Cache-control: no-cache Expires: Wed, 08 Jul 2015 16:57:01 GMT Content-Encoding: utf-8 x-oss-storage-class: Archive Content-Disposition: attachment;filename=oss_download.jpg Date: Wed, 08 Jul 2015 06:57:01 GMT Content-Type: image/jpg Content-Length: 1717 Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:kZoYNv66bsmc10+dcGKw5x2P**** [1717 bytes of object data]
返回示例HTTP/1.1 200 OK Date: Wed, 08 Jul 2015 06:57:01 GMT ETag: "0F7230CAA4BE94CCBDC99C550000****" Connection: keep-alive Content-Length: 0 Server: AliyunOSS x-oss-hash-crc64ecma: 14741617095266562575 x-oss-next-append-position: 1717 x-oss-request-id: 559CC9BDC755F95A64485981
SDK
此接口所对应的各语言SDK如下:
和其他操作的关系
其他操作 | 关系描述 |
---|---|
PutObject | 如果对一个已经存在的Appendable Object进行PutObject操作,该Appendable Object会被新的Object覆盖,类型变为Normal Object。 |
HeadObject | 对Appendable Object执行HeadObject操作会返回x-oss-next-append-position、x-oss-hash-crc64ecma以及x-oss-object-type。Appendable Object的x-oss-object-type为Appendable。 |
GetBucket | GetBucket请求的响应中,会把Appendable Object的Type设为Appendable。 |
CopyObject | 不能使用CopyObject来拷贝一个Appendable Object,也不能使用CopyObject改变Appendable Object的服务器端加密属性。可以使用CopyObject来改变自定义的元信息。 |
错误码
错误代码 | HTTP 状态码 | 说明 |
---|---|---|
ObjectNotAppendable | 409 | 对一个非Appendable Object进行AppendObject操作。 |
PositionNotEqualToLength | 409 |
|
InvalidArgument | 400 | x-oss-storage-class等值无效。 |
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论