append-object用于以追加写的方式上传文件(Object)。
注意事项
阿里云账号默认拥有设置和获取Object的权限。如果您需要通过RAM用户或者STS的方式进行设置和获取,您必须拥有
oss:PutObject
和oss: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=A和TagB=B。 |
append-object命令对应API接口AppendObject。关于API中的具体参数含义,请参见AppendObject。
关于支持的全局命令行选项,请参见支持的全局命令行选项。
使用示例
以字符串的形式追加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对象并指定该Object的Content-MD5值。
ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --content-md5 ohhnqLBJFiKkPSBO1eNaUA==