金山云-文档中心-流式上传（rcat）

rcat命令用于流式上传文件，需与管道配合使用，如果KS3上已存在同名文件，则会覆盖。

以下示例均以Linux为例。

命令格式

./ks3util rcat ks3://bucketname/objectKey 
[--storage-class <value>]
[--acl <value>] 
[--meta <value>] 
[--tagging <value>] 
[--sse-algorithm <value>]
[-j, --jobs <value>] 
[--part-size <value>]
[--disable-crc64]

参数说明

参数	说明
bucketname	操作的桶名。
objectKey	操作的对象名。
--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、SM4。
-j, --jobs	流式上传任务并发数，默认值：5，取值范围：1-10000。
--part-size	分块大小，默认情况下将根据文件大小自动计算合适的值。格式：值+单位默认单位：B（Byte）取值范围：5MB-5GB（5242880-5368709120） 1. 可选单位：B、KB、MB、GB。 2. 如果有特殊需求或需要性能调优，可以设置该值。
--disable-crc64	关闭 CRC64 数据校验。默认情况下数据传输时自动开启 CRC64 校验以确保完整性。

除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。

使用示例

流式上传文件。

grep 'REST.DELETE.OBJECT' ks3log_samplebucket_2023_01_01.log | ks3util rcat ks3://samplebucket/delete-object.log

流式上传文件并设置ACL。

grep 'REST.DELETE.OBJECT' ks3log_samplebucket_2023_01_01.log | ks3util rcat ks3://samplebucket/delete-object.log --acl public-read