全部文档
当前文档
最近更新时间：2025-11-07 15:07:05
append命令用于在已上传的追加类型文件（Appendable Object）末尾直接追加内容。当对象不存在时，使用该命令会创建新对象。
以下示例均以Linux为例。
./ks3util append local_file ks3://bucketname/objectname
[--storage-class <value>]
[--acl <value>]
[--meta <value>]
[--tagging <value>]
[--sse-algorithm <value>]参数 | 说明 |
|---|---|
local_file | 本地文件路径。 |
bucketname | 目标桶名称。 |
objectname | 追加上传操作的对象名称。 |
--storage-class | 设置对象的存储类型，可选值：STANDARD、STANDARD_IA、ARCHIVE。仅在文件首次追加上传时有效，后续追加上传时不生效。 |
--acl | 设置对象的访问权限，可选值：private 、public-read。仅在文件首次追加上传时有效，后续追加上传时不生效。 |
--meta | 设置对象的元数据，格式为：header:value#header:value（多组值之间以#分隔），例如：Cache-Control:no-cache#Content-Encoding:gzip。仅在文件首次追加上传时有效，后续追加上传时不生效。 |
--tagging | 设置对象的标签，格式为："TagA=A&TagB=B"（多个标签以&分隔），例如："tag1=value1&tag2=value2"。仅在文件首次追加上传时有效，后续追加上传时不生效。 该选项的值需要使用双引号包含。 |
--sse-algorithm | 设置服务端加密算法，可选值：AES256。仅在文件首次追加上传时有效，后续追加上传时不生效。 |
除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。
将本地文件sample.txt首次追加上传
./ks3util append sample.txt ks3://samplebucket/sampleobject.txt存储空间内已存在sampleobject.txt文件，将本地文件sample.txt追加上传至sampleobject.txt的末尾。
./ks3util append sample.txt ks3://samplebucket/sampleobject.txt将本地文件sample.txt首次追加上传，并设置存储类型。
./ks3util append sample.txt ks3://samplebucket/sampleobject.txt --storage-class STANDARD将本地文件sample.txt首次追加上传，并设置访问权限。
./ks3util append sample.txt ks3://samplebucket/sampleobject.txt --acl private将本地文件sample.txt首次追加上传，并设置meta信息。
./ks3util append sample.txt ks3://samplebucket/sampleobject.txt --meta "x-kss-meta-key1:value1#x-kss-meta-key2:value2"将本地文件sample.txt首次追加上传，并设置标签信息。
./ks3util append sample.txt ks3://samplebucket/sampleobject.txt --tagging "tag1=value1&tag2=value2"将本地文件sample.txt首次追加上传，并设置加密算法。
./ks3util append sample.txt ks3://samplebucket/sampleobject.txt --sse-algorithm AES256纯净模式