append-object

append-object用于以追加写的方式上传文件(Object)。

注意事项

  • 阿里云账号默认拥有设置和获取Object的权限。如果您需要通过RAM用户或者STS的方式进行设置和获取,您必须拥有oss:PutObjectoss:GetObject权限。具体操作,请参见RAM用户授权自定义的权限策略

  • 通过append-object方式最后生成的Object大小不得超过5 GB。

  • append-object不支持指定CMK ID进行服务端KMS加密。

命令格式

ossutil api append-object --bucket value --key value --position value [flags]

参数

类型

说明

--body

string

请求体。

--bucket

string

Bucket名称。

--cache-control

string

指定该Object的网页缓存行为。

--content-disposition

string

指定该Object被下载时的名称。

--content-encoding

string

指定该Object的内容编码格式。

--content-md5

string

是一串由MD5算法生成的值,该请求头用于检查消息内容是否与发送时一致。

--expires

string

过期时间。

--key

string

Object的完整路径。

--metadata

stringArray

指定设置的元数据,如需要自定义携带的元数据,需配置以x-oss-meta-*为前缀的参数。

--object-acl

string

指定Object的访问权限。

--position

string

用于指定从何处进行追加。

--server-side-encryption

string

指定服务器端加密方式。

--storage-class

string

指定Object的存储类型。

--tagging

string

指定Object的对象标签,可同时设置多个标签,例如TagA=ATagB=B。

说明

使用示例

  • 以字符串的形式追加exampleobject对象。

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss"
  • 以文件的形式追加exampleobject对象。

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body file://appendFile
  • 以字符串的形式追加exampleobject对象并携带自定义元数据。

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --metadata user=aliyun --metadata email=ali***@aliyuncs.com
  • 以字符串的形式追加exampleobject对象并指定object的标签信息。

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --tagging "TagA=A&TagB=B"
  • 以字符串的形式追加exampleobject对象并指定object的访问权限以及存储类型。

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --object-acl private --storage-class IA
  • 以字符串的形式追加exampleobject对象并指定object服务器端加密方式。

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --body "hi oss" --server-side-encryption AES256
  • 以字符串的形式上传文件并指定该Object被下载时网页的缓存行为。

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --cache-control no-cache
  • 以字符串的形式上传文件并指定该Object下载时的名称。

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --content-disposition "attachment;filename=oss_download.jpg"
  • 以字符串的形式追加exampleobject对象并指定该ObjectContent-MD5值。

    ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --content-md5 ohhnqLBJFiKkPSBO1eNaUA==