Skip to content

Latest commit

 

History

History
62 lines (51 loc) · 4.33 KB

batchchtype.md

File metadata and controls

62 lines (51 loc) · 4.33 KB

简介

batchchtype 命令用来为空间中的文件设置存储类型。该操作发生在同一个空间中。(将文件设置为 深度归档存储 或者 归档存储 或者 归档直读存储 或者 低频存储 或者 普通存储,默认:文件为 普通存储

格式

qshell batchchtype  [--force] [--success-list <SuccessFileName>] [--failure-list <FailureFileName>] [--sep <Separator>]  [--worker <WorkerCount>] <Bucket> [-i <KeyFileTypeMapFile>]

帮助文档

可以在命令行输入如下命令获取帮助文档:

// 简单描述
$ qshell batchchtype -h 

// 详细文档(此文档)
$ qshell batchchtype --doc

鉴权

需要使用 qshell account 或者 qshell user add 命令设置鉴权信息 AccessKey, SecretKeyName

参数

  • Bucket:空间名,可以为公开空间或私有空间。【必选】

选项

  • -i/--input-file:接受一个文件, 文件内容每行包含 原文件名存储类型,存储类型用数字表示,0 为普通存储,1 为低频存储,2 为归档存储,3 为深度归档存储,4 为归档直读存储。每行多个元素名之间用分割符分隔(默认 tab 制表符); 如果需要自定义分割符,可以使用 -F--sep 选项指定自定义的分隔符。如果没有通过该选项指定该文件参数, 从标准输入读取内容。每行包含 文件名存储类型;具体格式如下:(【可选】)
<Key><Sep>1     // <Key>:文件名,<Sep>:分割符,1:低频存储。
  • -y/--force:该选项控制工具的默认行为。默认情况下,对于批量操作,工具会要求使用者输入一个验证码,确认下要进行批量文件操作了,避免操作失误的发生。如果不需要这个验证码的提示过程可以使用此选项。【可选】
  • -s/--success-list:该选项指定一个文件,程序会把操作成功的资源信息导入到该文件;默认不导出。【可选】
  • -e/--failure-list:该选项指定一个文件,程序会把操作失败的资源信息加上错误信息导入该文件;默认不导出。【可选】
  • -F/--sep:该选项可以自定义每行输入内容中字段之间的分隔符(文件输入或标准输入,参考 -i 选项说明);默认为 tab 制表符。【可选】
  • -c/--worker:该选项可以定义 Batch 任务并发数;1 路并发单次操作对象数为 250 ,如果配置为 10 并发,则 10 路并发单次操作对象数为 2500,此值需要和七牛对您的操作上限相吻合,否则会出现非预期错误,正常情况不需要调节此值,如果需要请谨慎调节;默认为 4。【可选】
  • --min-worker:最小 Batch 任务并发数;当并发设置过高时,会触发超限错误,为了缓解此问题,qshell 会自动减小并发度,此值为减小的最低值。默认:1【可选】
  • --worker-count-increase-period:为了尽可能快的完成操作 qshell 会周期性尝试增加并发度,此值为尝试增加并发数的周期,单位:秒,最小 10,默认 60。【可选】
  • --enable-record:记录任务执行状态,当下次执行命令时会检测任务执行的状态并跳过已执行的任务。 【可选】
  • --record-redo-while-error:依赖于 --enable-record;命令重新执行时,命令中所有任务会从头到尾重新执行;每个任务执行前会根据记录先查看当前任务是否已经执行,如果任务已执行且失败,则再执行一次;默认为 false,当任务执行失败则跳过不再重新执行。 【可选】

示例

1 比如我们要将空间 if-pbl 里面的一些文件改为低频存储,我们可以指定如下的 KeyFileTypeMapFile 的内容:

2015/03/22/qiniu.png	1
2015/photo.jpg	1
2015/03/22/qiniu2.png	0
2015/photo2.jpg	2

上面,我们将 2015/03/22/qiniu.png 文件设置为低频存储了,诸如此类。 把这个内容保存到文件 tochangetype.txt 中,然后使用如下的命令将 tochangetype.txt 中所有的文件进行存储类型改变。

$ qshell batchchtype if-pbl -i tochangetype.txt

2 如果不希望上面的重命名过程出现验证码提示,可以使用 -force 选项:

$ qshell batchchtype --force if-pbl -i tochangetype.txt

注意

如果没有指定输入文件的话,默认会从标准输入读取同样格式的内容。