最近更新时间:2024-12-13 18:50:11
本文为您介绍KS3Util的辅助命令。
config命令用于创建配置文件,存储KS3访问信息,在使用其他命令时添加-c选项,KS3Util将通过指定的配置来访问KS3。
该命令有交互式和非交互式两种用法。交互式用法为用户根据提示输入相应信息,命令结束时生成配置文件。非交互式则需要通过选项来指定需要的配置项。相比非交互式用法,交互式用法具有更高的安全性。
如果使用命令时输入了除-L
,--languange
和-c
,--config-file
以外的任意选项,则进入非交互式模式,所有的配置项需通过选项来指定。
./ks3util config
[-e, --endpoint <value>]
[-i, --access-key-id <value>]
[-k, --access-key-secret <value>]
[-L, --language <value>]
[--output-dir <value>]
[-c, --config-file <value>]
参数 | 说明 |
---|---|
-e, --endpoint | KS3Util工具的基本endpoint配置(该选项值会覆盖配置文件中的相应设置),注意其必须为一个二级域名,如:ks3-cn-beijing.ksyuncs.com。 |
-i, --access-key-id | 访问ks3使用的AccessKeyID(该选项值会覆盖配置文件中的相应设置)。 |
-k, --access-key-secret | 访问ks3使用的AccessKeySecret(该选项值会覆盖配置文件中的相应设置)。 |
-L, --language | 指定语言。CH(默认值):中文。EN:英文。设置为CH时,请确保系统编码方式为UTF-8。 |
--output-dir | 指定输出文件所在的目录,输出文件目前包含:cp命令批量拷贝文件出错时所产生的report文件。默认值为:当前目录下的ks3util_output目录。 |
-c, --config-file | KS3Util工具的配置文件路径,KS3Util启动时从配置文件读取配置,在config命令中,KS3Util将配置写入该文件。 |
交互式用法
./ks3util config
该命令将创建一个配置文件,在其中存储配置信息。
请输入配置文件名,文件名可以带路径(默认为:/home/user/.ks3utilconfig,回车将使用默认配置文件。如果用户设置为其它文件,在使用命令时需要将--config-file选项设置为该文件):my_ks3util.conf
对于下述配置,回车将跳过相关配置项的设置,配置项的具体含义,请使用"help config"命令查看。
请输入语言(CH/EN,默认为:CH,该配置项将在此次config命令成功结束后生效):CH
请输入endpoint:ks3-cn-beijing.ksyuncs.com
请输入accessKeyID:my-access-key-id
请输入accessKeySecret:my-access-key-secret
非交互式用法
./ks3util config -e ks3-cn-beijing.ksyuncs.com -i my-access-key-id -k my-access-key-secret -L CH -c my_ks3util.conf
编辑配置文件
对于已经生成的配置文件,也可以通过直接修改配置文件来修改KS3访问信息。KS3Util工具的配置文件格式如下:
[Credentials]
language = CH
endpoint = ks3-cn-beijing.ksyuncs.com
accessKeyID = your_key_id
accessKeySecret = your_key_secret
outputDir = your_output_dir
help命令用来获取命令的帮助信息,当不清楚某个命令的用法时,建议使用help命令获取该命令的帮助信息。
./ks3util help [command]
获取KS3Util支持的所有命令
./ks3util help
查看所有选项信息
./ks3util help -h
查看某个命令的帮助信息,如:cp命令
./ks3util help cp
hash命令用于计算本地文件的CRC64或MD5值。
./ks3util hash localfile [--type <value>]
参数 | 说明 |
localfile | 本地文件的完整路径。 |
--type | 数据完整性校验算法类型,可选值有crc64|md5。
|
您可以通过stat命令中返回的Content-Md5和X-Kss-Checksum-Crc64ecma分别获取KS3内文件的Content-MD5和CRC64值。
在KS3支持CRC64校验之前上传至Bucket内的文件,不支持通过stat命令查看文件的CRC64值。
对于通过分块上传或追加上传方式上传的文件,不支持通过stat命令查看文件的Content-MD5值。
计算本地文件localfile.txt的CRC64值
./ks3util hash localfile.txt --type crc64
计算本地文件localfile.txt的MD5值
./ks3util hash localfile.txt --type md5
update命令用于KS3Util更新版本。该命令会联网检查是否有新版本,如果有新版本,则询问是否进行更新;如果指定了–force选项,则不询问。
./ks3util update [-f, --force]
参数 | 说明 |
---|---|
-f, --force | 强制操作,不进行询问提示。 |
./ks3util update
当前版本为:1.0.0,最新版本为:2.0.0
确定更新版本(y or N)? y
更新成功!
纯净模式