-k, --access-key-secret= 访问oss使用的AccessKeySecret(该选项值会覆盖配置文件中的相应设置)。
--item= 表示命令的功能类型,取值为LOCATION、PROGRESS等
--bigfile-threshold= 开启大文件断点续传的文件大小阈值,默认值:100M,取值范围:0B-9223372036854775807B
-j, --jobs= 多文件操作时的并发任务数,默认值:3,取值范围:1-10000
--proxy-user= 网络代理服务器的用户名,默认为空
--sts-region= 指定sts endpoint的地区,比如cn-shenzhen,其中,cn指代的是国家,shenzhen指代的是地区,用于构造sts endpoint,该选项缺省时,sts endpoint为sts.aliyuncs.com,主要用于RamRoleArn模式
--parallel= 单文件内部操作的并发任务数,取值范围:1-10000, 默认将由ossutil根据操作类型和文件大小自行决定。
--marker= 列举Buckets时的marker,或列举objects或Multipart Uploads时的key marker, 或者其他有需要marker的地方。
--delete 删除操作
--range= 下载文件时,指定文件下载的范围,格式为:3-9或3-或-9
--upload 表示上传到oss,主要在命令probe中使用
--end-time= 结束时间,为linux/Unix系统里面的时间戳,既从1970年1月1日(UTC/GMT的午夜)开始所经过的秒数
--ecs-role-name= 表示角色名,主要用于EcsRamRole模式
--exclude= 不包含对象匹配模式,如:*.txt
-L, --language= 设置ossutil工具的语言,默认值:CH,取值范围:CH/EN,若设置成"CH",请确保您的系统编码为UTF-8。
-s, --short-format 显示精简格式,如果未指定该选项,默认显示长格式。
--kms-data-encryption= 表示kms秘钥托管服务使用的加密算法,目前取值仅支持为SM4, 或者为空
--ram-role-arn= 表示RAM角色的ARN,主要用于RamRoleArn模式
--meta= 设置object的meta为[header:value#header:value...],如:Cache-Control:no-cache#Content-Encoding:gzip
--version-id= 表示object的版本id
--probe-item= 表示probe命令的探测项目, 取值可为upload-speed, download-speed, cycle-symlink
--tagging= 设置object的tagging,取值格式如["TagA=A&TagB=B..."]
--read-timeout= 表示客户端读超时的时间,单位为秒, 缺省值为1200
--only-current-dir 表示仅操作当前目录下的文件或者object, 忽略子目录
--redundancy-type= 表示bucket的数据容灾类型, 取值可为LRS, ZRS. LRS为默认值,表示本地容灾, ZRS表示更高可用的同城多可用区容灾(3AZ)
--part-size= 分片大小,单位为Byte,默认情况下ossutil根据文件大小自行计算合适的分片大小值。如果有特殊需求或者需要性能调优,可以设置该值,取值范围:1-9223372036854775807(Byte)
--retry-times= 当错误发生时的重试次数,默认值:10,取值范围:1-500
--disable-encode-slash 表示不对url path中的'/'进行编码, 主要用于sign命令
--disable-ignore-error 批量操作时候不忽略错误, 缺省值为false
--skip-verify-cert 表示不校验服务端的数字证书
-c, --config-file= ossutil工具的配置文件路径,ossutil启动时从配置文件读取配置,在config命令中,ossutil将配置写入该文件。
-t, --sts-token= 访问oss使用的STSToken(该选项值会覆盖配置文件中的相应设置),非必须设置项。
--disable-crc64 该选项关闭crc64,默认情况下,ossutil进行数据传输都打开crc64校验。
--sse-algorithm= 表示服务端加密算法,取值为KMS或者AES256
--all-versions 表示object所有版本
--ua= 指定http请求中的user agent, 会在缺省值后面加上指定值
--type= 计算的类型, 默认值:crc64, 取值范围: crc64/md5
--include= 包含对象匹配模式,如:*.jpg
-u, --update 更新操作
--origin= 表示http请求头origin字段的值
--partition-download= 分区下载使用,一个ossutil命令下载一个分区,其值格式为"分区编号:总分区数",比如1:5,表示当前ossutil下载分区1,总共有5个分区;分区号从1开始编号,objects的分区规则由工具内部算法决定;利用该选项,待下载的objects分成多个区,可以由多个ossutil命令一起下载完成,每个ossutil命令下载各自的分区,多个ossutil命令可以并行在不同机器上执行
--acr-method= 表示http header Access-Control-Request-Method的值,主要用于cors-options命令
-e, --endpoint= ossutil工具的基本endpoint配置(该选项值会覆盖配置文件中的相应设置),注意其必须为一个二级域名。
--start-time= 起始时间,为linux/Unix系统里面的时间戳,既从1970年1月1日(UTC/GMT的午夜)开始所经过的秒数
--backup-dir= sync命令使用的备份文件的目录
-a, --all-type 指定操作的对象为bucket中的object和未完成的Multipart事件。
--addr= 表示一个网络地址,通常为域名,主要在命令probe中使用
--disable-empty-referer 表示不允许referer字段为空,主要在referer命令中使用
--kms-masterkey-id= 表示kms秘钥托管服务中的主秘钥id
--proxy-host= 网络代理服务器的url地址,支持http/https/socks5,比如 https://120.79.128.211:3128, socks5://120.79.128.211:1080
--token-timeout= 表示token的有效时间,单位为秒, 缺省值为3600,主要用于RamRoleArn模式下的AssumeRole参数
--checkpoint-dir= checkpoint目录的路径(默认值为:.ossutil_checkpoint),断点续传时,操作失败ossutil会自动创建该目录,并在该目录下记录checkpoint信息,操作成功会删除该目录。如果指定了该选项,请确保所指定的目录可以被删除。
-i, --access-key-id= 访问oss使用的AccessKeyID(该选项值会覆盖配置文件中的相应设置)。
-r, --recursive 递归进行操作。对于支持该选项的命令,当指定该选项时,命令会对bucket下所有符合条件的objects进行操作,否则只对url中指定的单个object进行操作。
--upmode= 表示上传模式,缺省值为normal,取值为:normal|append|multipart,分别表示正常上传、追加上传、分块上传,主要在命令probe中使用
-p, --password 表示从键盘输入accessKeySecret参数
-B, --block-size= 表示du命令字节显示的单位,取值可以为KB, MB, GB, TB
--connect-timeout= 表示客户端连接超时的时间,单位为秒, 缺省值为120
--output-dir= 指定输出文件所在的目录,输出文件目前包含:cp命令批量拷贝文件出错时所产生的report文件(关于report文件更多信息,请参考cp命令帮助)。默认值为:当前目录下的ossutil_output目录。
--encoding-type= 输入或者输出的object名或文件名的编码方式,目前只支持url encode,即指定该选项时,取值范围为:url,如果不指定该选项,则表示object名或文件名未经过编码。bucket名不支持url encode。注意,如果指定了该选项,则形如oss://bucket/object的cloud_url,输入形式为:oss://bucket/url_encode(object),其中oss://bucket/字符串不需要编码。
--snapshot-path= 该选项用于在某些场景下加速增量上传批量文件或者增量下载批量object。在cp上传文件或者下载object时使用该选项,ossutil在指定的目录下生成快照文件,记录文件上传或者object下载的快照信息,在下一次指定该选项上传或下载时,ossutil会读取指定目录下的快照信息进行增量上传或者下载。用户指定的snapshot目录必须为本地文件系统上的可写目录,若该目录不存在,ossutil会创建该文件用于记录快照信息,如果该目录已存在,ossutil会读取里面的快照信息,根据快照信息进行增量上传(只上传上次未成功上传的文件和本地进行过修改的文件)或者增量下载(只下载上次未成功下载的object和修改过的object),并更新快照信息。注意:该选项在本地记录了成功上传的文件的本地lastModifiedTime或者记录了下载object的lastModifiedTime,从而在下次上传或者下载时通过比较lastModifiedTime来决定是否跳过相同文件的上传或者跳过相同的object下载。当使用该选项上传时,请确保两次上传期间没有其他用户更改了oss上的对应object。当不满足该场景时,如果想要增量上传批量文件,请使用--update选项。ossutil不会主动删除snapshot-path下的快照信息,当用户确定快照信息无用时,请用户及时自行删除snapshot-path。
--maxdownspeed= 最大下载速度,单位:KB/s,缺省值为0(不受限制)
--download 表示从oss下载,主要在命令probe中使用
--url= 表示一个url地址,主要在命令probe中使用
--mode= 表示鉴权模式,取值可以为AK,StsToken,RamRoleArn,EcsRamRole,缺省值为空
--limited-num= 返回结果的最大个数。
--upload-id-marker= 列举Multipart Uploads时的uploadID marker。
-m, --multipart 指定操作的对象为bucket中未完成的Multipart事件,而非默认情况下的object。
--bucketname= 表示bucket的名称,主要在命令probe中使用
--object= 表示oss中对象的名称,主要在命令probe中使用
--version-id-marker= 表示列举objects所有版本的version id marker
--trafic-limit= http请求限速,单位:bit/s,缺省值为0(不受限制),用于sign命令
--local-host= 工具的ip地址,比如 127.0.0.1
--enable-symlink-dir 表示允许上传链接子目录下的文件,默认不上传; probe命令可以探测是否存在死循环链接文件或者目录
--role-session-name= 表示会话名字,主要用于RamRoleArn模式
-v, --version 显示ossutil的版本(v1.7.10)并退出。
--proxy-pwd= 网络代理服务器的密码,默认为空
--disable-dir-object 表示上传文件时不为目录生成oss对象,主要用于cp命令
-d, --directory 返回当前目录下的文件和子目录,而非递归显示所有子目录下的所有object。
-f, --force 强制操作,不进行询问提示。
--payer= 请求的支付方式,如果为请求者付费模式,可以将该值设置成"requester"
--maxupspeed= 最大上传速度,单位:KB/s,缺省值为0(不受限制)
--acr-headers= 表示http header Access-Control-Request-Headers的值,主要用于cors-options命令
--storage-class= 设置对象的存储方式,默认值:Standard,取值范围:Standard/IA/Archive/ColdArchive。
--timeout= 签名url的超时时间,单位为秒,默认值为:60,取值范围:0-9223372036854775807
--acl= acl信息的配置。
-b, --bucket 对bucket进行操作,该选项用于确认操作作用于bucket
--loglevel= 日志级别,默认为空,表示不输出日志文件,可选值为:info|debug,info输出提示信息日志,debug输出详细信息日志(包括http请求和响应信息)
--method= 表示命令的操作类型,取值为PUT、GET、DELETE、LIST等
--disable-all-symlink 表示不允许上传目录下的链接文件以及链接目录, 缺省值为false
-h, --help Show usage message
--version Show version
例:
将本地路径 Users/user/Documents/paperjson/ucweb20220418/tikuimages/ 的文件更新到 oss://quark-souti/khtk_imgs_new/kuaihuo/tikuimages/ ,并发为100
./ossutilmac64 cp -u --jobs=100 -r ~/Users/user/Documents/paperjson/ucweb20220418/tikuimages/ oss://quark-souti/khtk_imgs_new/kuaihuo/tikuimages/