文档

append(追加上传)

更新时间:

append命令用于在已上传的追加类型对象(Appendable Object)末尾直接追加内容。

注意事项

  • 要追加上传,您必须具有oss:GetObjectoss:PutObject权限。具体操作,请参见为RAM用户授权自定义的权限策略

  • 关于追加上传的更多信息,请参见追加上传

  • 如果对象不存在,则创建追加类型的对象;如果对象已存在,且不是追加类型的,则返回错误。

命令格式

ossutil append source oss://bucket/object [flags]

参数

类型

说明

source

string

表示数据源,支持本地路径、OSS资源地址和-

当为-时,表示从标准输入读入。

--acl

string

对象的访问权限。取值:

  • private:私有。

  • public-read:公共读。

  • public-read-write:公共读写。

  • default:继承Bucket。

--cache-control

string

指定该对象被下载时网页的缓存行为。

--content-disposition

string

指定对象的展示形式。

--content-encoding

string

声明对象的编码方式。

--content-type

string

对象的内容类型。

--encoding-type

string

输入的对象名或文件名的编码方式。取值:url。

--expires

string

指定缓存内容的绝对过期时间。

--metadata

strings

指定对象的用户元数据,使用key=value格式。

--request-payer

string

请求的支付方式,如果为请求者付费模式,请设置该值。取值:requester。

--storage-class

string

对象的存储类型, 取值:

  • Standard:标准存储。

  • IA:低频存储。

  • Archive:归档存储。

  • ColdArchive:冷归档存储。

  • DeepColdArchive:深度冷归档存储。

--tagging

strings

指定对象的标签,使用key=value格式。

说明

关于支持的全局命令行选项,请参见支持的全局命令行选项

使用示例

  • 首次上传本地文件1.txt,并指定文件读写权限为私有,标签为tag=value。

    ossutil append 1.txt oss://dst-bucket/append.txt --acl private --tagging tag=value
  • 采用标准输入方式,在append.txt文件末尾追加2.txt。

    cat 2.txt | ossutil append - oss://dst-bucket/append.txt
  • 把存储空间src-bucket里的3.txt追加到append.txt文件末尾。

    ossutil append oss://src-bucket/3.txt oss://dst-bucket/append.txt