更新时间:2024-11-15 gmt 08:00
追加写对象-九游平台
功能介绍
追加写对象操作是指在指定桶内的一个对象尾追加上传数据,不存在相同对象键值的对象则创建新对象。
通过append object操作创建的object类型为appendable object,而通过put object上传的object是normal object。
用户上传的对象存储在桶中。用户必须对桶有write权限,才可以在桶中上传对象。同一个桶中存储的对象名必须是唯一的。
为了确保数据在传输过程中没有遭到破坏,用户可以在请求消息头中加入content-md5参数,obs收到上传数据后,会对数据进行md5校验,如果不一致则返回出错信息。
该操作支持在创建appendable对象时指定x-obs-acl参数,设置对象的权限控制策略。
该操作支持服务端加密功能。
和其他操作的关系
- 对一个已经存在的appendable对象进行put object操作,那么该appendable对象会被新object覆盖,类型变为normal对象,反之出错。
- appendable对象复制后变成normal对象,不支持appenable对象复制成appendable对象。
worm
在开启了worm开关的桶中,使用追加写上传对象将失败并返回403。
约束
- 每次追加上传都会更新该对象的最后修改时间。
- 服务端加密sse-c方式,那么追加上传和初始化段一样,设置诸如x-obs-server-side-encryption之类的请求header,后续追加上传也必须携带。
- 服务端加密sse-kms方式,有且只有第一次上传且桶内不存在同名对象时,才设置诸如x-obs-server-side-encryption之类的请求header,后续追加上传不携带。
- 每次追加上传的长度不能超过对象长度上限5g的限制。
- 每个appendable对象追加写次数最多为10000次。
- 如果对象存储类型为cold(归档存储)或deep_archive(深度归档存储),则不能调用该接口。
- 如果桶设置了跨区域复制配置,则不能调用该接口。
- 并行文件系统不支持追加写对象。
请求消息样式
post /objectname?append&position=position http/1.1 host: bucketname.obs.cn-north-4.myhuaweicloud.com content-type: application/xml content-length: length authorization: authorization date: date