更新时间: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参数,设置对象的权限控制策略。

该操作支持服务端加密功能。

和其他操作的关系

  1. 对一个已经存在的appendable对象进行put object操作,那么该appendable对象会被新object覆盖,类型变为normal对象,反之出错。
  2. appendable对象复制后变成normal对象,不支持appenable对象复制成appendable对象。

worm

在开启了worm开关的桶中,使用追加写上传对象将失败并返回403。

约束

  1. 每次追加上传都会更新该对象的最后修改时间。
  2. 服务端加密sse-c方式,那么追加上传和初始化段一样,设置诸如x-obs-server-side-encryption之类的请求header,后续追加上传也必须携带。
  3. 服务端加密sse-kms方式,有且只有第一次上传且桶内不存在同名对象时,才设置诸如x-obs-server-side-encryption之类的请求header,后续追加上传不携带。
  4. 每次追加上传的长度不能超过对象长度上限5g的限制。
  5. 每个appendable对象追加写次数最多为10000次。
  6. 如果对象存储类型为cold(归档存储)或deep_archive(深度归档存储),则不能调用该接口。
  7. 如果桶设置了跨区域复制配置,则不能调用该接口。
  8. 并行文件系统不支持追加写对象。

请求消息样式

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
 
网站地图