功能说明
根据任务号（TaskId）恢复失败的上传任务。
命令结构
● Windows操作系统
obsutil cp -recover=xxx arcDir=xxx] dryRun] f] u] vlength] vmd5] j=1] p=1] threshold=52428800] acl=xxx] sc=xxx] meta=aaa:bbb#ccc:ddd] ps=auto] include=*.xxx] exclude=*.xxx] timeRange=time1-time2] mf] o=xxx] cpd=xxx] clear] config=xxx] e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
● macOS/Linux操作系统
./obsutil cp -recover=xxx arcDir=xxx] dryRun] f] u] vlength] vmd5] j=1] p=1] threshold=52428800] acl=xxx] sc=xxx] meta=aaa:bbb#ccc:ddd] ps=auto] include=*.xxx] exclude=*.xxx] timeRange=time1-time2] mf] o=xxx] cpd=xxx] clear] config=xxx] e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
运行示例
● 以Windows操作系统为例，运行obsutil cp -recover 104786c8-27c2-48fc-bc6a-5886596fb0ed -f，恢复失败的上传任务。
obsutil cp -recover 104786c8-27c2-48fc-bc6a-5886596fb0ed -f Parallel: 3 Jobs: 3
Threshold: 524288000 PartSize: 5242880 Exclude: Include:
VerifyLength: false VerifyMd5: false CheckpointDir: xxxx
OutputDir: xxxx
[========================================================] 100.00% 2.02 KB/s 0s Succeed count is: 5 Failed count is: 0
Metrics [max cost:90 ms, min cost:45 ms, average cost:63.80 ms, average tps:35.71]
Task id is: a628d6da-c562-4a1f-b687-4fa125de0dc3
参数说明
参数 约束 描述
recover 附加参数，必 选
待恢复上传任务结果清单文件的任务号。
说明
● 任务号（TaskId）可在每次上传任务运行完毕后获取，或 者通过结果清单文件名查询（文件名除去后缀.txt后的后 36位）。
● 待恢复的上传任务会从结果清单的文件夹中查找，结果 清单文件夹的路径参考附加参数o。
arcDir 附加参数，可 选
上传文件成功后的归档路径，上传成功后的文件会移 动到该路径下。
dryRun 附加参数，可 选
vlength 附加参数，可 选
● MD5值校验通过后，会将该值设置为对象元数据x-obs-md5chksum，用于下载或复制时校验MD5。
p 附加参数，可
选
每个分段上传任务的最大并发数，默认为配置文件中 的defaultParallels。
threshold 附加参数，可 选
● 支持带容量单位配置，例如，配置1MB代表1048576字 节。
参数 约束 描述 acl 附加参数，可
选
上传文件时可指定的预定义访问策略。支持的值：
● private
● public-read
● public-read-write 说明
● standard：标准存储，访问时延低、吞吐量高，适 用于有大量热点文件（平均一个月多次）或小文件
（小于1MB）。
● warm：低频访问存储，可用性略低于standard，
适用于不频繁访问（平均一年少于12次）但在需要
● 支持带容量单位配置，例如，配置1MB代表1048576字 节。
● 支持配置为auto，此时obsutil会根据源文件大小自动设 置每个分段任务的段大小。
cpd 附加参数，可
选 生成断点记录文件的文件夹，默认为运行obsutil命令 的用户目录的子文件夹.obsutil_checkpoint。
参数 约束 描述 exclude 附加参数，可
选 不包含文件的匹配模式，如：*.txt。
说明
● 支持“*”匹配多个任意字符和“?”匹配单个任意字符，
例如abc*.txt代表匹配以abc开头以.txt结尾的任意文件。
● 您可以使用“\*”代表匹配“*”字符本身，使用“\?”
代表匹配“?”字符本身。
● 如果待上传的文件名匹配该参数，则跳过该文件的上 传。
须知
● 建议使用引号传递该匹配模式（macOS/Linux操作系统 使用单引号，Windows操作系统使用双引号）防止特殊 符号被操作系统转义，导致不可预期的结果。
● 该匹配模式作用于文件全路径（含文件名和文件目 录）。
● 该匹配模式不适用于文件夹。
● 支持指定多个exclude参数，如exclude=*.xxx -exclude=*.xxx
include 附加参数，可
选 包含文件的匹配模式，如：*.jpg。
说明
● 支持“*”匹配多个任意字符和“?”匹配单个任意字符。
● 您可以使用“**”代表匹配“*”字符本身，使用“\?”
代表匹配“?”字符本身。
● 首先执行exclude的匹配规则，如果待上传的文件名不匹 配exclude，则判断待上传的文件名是否匹配该参数，如 果匹配则上传该文件，否则跳过该文件的上传。
须知
● 建议使用引号传递该匹配模式（macOS/Linux操作系统 使用单引号，Windows操作系统使用双引号）防止特殊 符号被操作系统转义，导致不可预期的结果。
● 该匹配模式作用于文件全路径（含文件名和文件目 录）。
● 该匹配模式不适用于文件夹。
● 支持指定多个include参数，如include=*.xxx -include=*.xxx
at 附加参数，可
选 恢复上传文件时指定按照文件最后访问时间作为 timeRange匹配模式，仅上传最后访问时间满足 timeRange时间段的文件。
说明
● 需配合timeRange使用
参数 约束 描述
● 使用“time1-time2”，代表匹配的时间段，其中time1 必须小于等于time2，格式为yyyyMMddHHmmss。
● 时间格式支持自动补全，例如yyyyMMdd等价于 yyyyMMdd000000，yyyyMM等价于
yyyyMM01000000。
● 使用“*-time2”，代表匹配最后修改时间在time2之前 的所有文件，使用“time1-*”，代表匹配最后修改时间 time1之后的所有文件。
须知该匹配模式表示的时间是UTC时间。
mf 附加参数，可
选 设置名称匹配模式（include、exclude）和时间匹配 模式（timeRange）对对象名以“/”结尾的对象也生
● 结果清单文件命名规则：cp_{succeed | failed | warning}_report_时间_TaskId.txt。
config 附加参数，可 选
参数 约束 描述
t 附加参数，可
选 指定用户的securitytoken。
响应结果
请参考上传对象的响应结果。
5.16 恢复失败的复制任务
功能说明
根据任务号（TaskId）恢复失败的复制任务。
命令结构
● Windows操作系统
obsutil cp -recover=xxx dryRun] f] u] crr] vlength] vmd5] j=1] p=1]
threshold=52428800] acl=xxx] sc=xxx] meta=aaa:bbb#ccc:ddd] ps=auto] include=*.xxx] exclude=*.xxx] timeRange=time1-time2] mf] o=xxx] cpd=xxx] clear] config=xxx] e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
● macOS/Linux操作系统
./obsutil cp -recover=xxx dryRun] f] u] crr] vlength] vmd5] j=1] p=1]
threshold=52428800] acl=xxx] sc=xxx] meta=aaa:bbb#ccc:ddd] ps=auto] include=*.xxx] exclude=*.xxx] timeRange=time1-time2] mf] o=xxx] cpd=xxx] clear] config=xxx] e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
运行示例
● 以Windows操作系统为例，运行obsutil cp -recover=0476929d-9d23-4dc5-b2f8-0a0493f027c5 -f，批量复制对象。
obsutil cp -recover=0476929d-9d23-4dc5-b2f8-0a0493f027c5 -f Parallel: 3 Jobs: 3
Threshold: 524288000 PartSize: 5242880 Exclude: Include:
VerifyLength: false VerifyMd5: false CheckpointDir: xxxx
OutputDir: xxxx
[=============================================================] 100.00% 10/s 0s Succeed count is: 1 Failed count is: 0
Metrics [max cost:298 ms, min cost:192 ms, average cost:238.00 ms, average tps:9.71]
Task id is: f4c4f2b6-6e54-4dff-96b8-52e8c8c9a4b0
参数说明
参数 约束 描述
recover 附加参数，
必选
待恢复复制任务结果清单文件的任务号。
说明
● 任务号（TaskId）可在每次复制任务运行完毕后获取，
或者通过结果清单文件名查询（文件名除去后缀.txt后 的后36位）。
● 待恢复的复制任务会从结果清单的文件夹中查找，结果 清单文件夹的路径参考附加参数o。
dryRun 附加参数，
可选
vlength 附加参数，
可选
● 源桶中对象必须包含元数据x-obs-md5chksum，否则会 忽略MD5值校验。
参数 约束 描述 threshold 附加参数，
可选
● 支持带容量单位配置，例如，配置1MB代表1048576字 节。
acl 附加参数，
可选
复制对象时可指定的目标对象的预定义访问策略。支 持的值：
● private
● public-read
● public-read-write 说明
● standard：标准存储，访问时延低、吞吐量高，
适用于有大量热点文件（平均一个月多次）或小 文件（小于1MB）。
● warm：低频访问存储，可用性略低于standard，
适用于不频繁访问（平均一年少于12次）但在需
● 支持带容量单位配置，例如，配置1MB代表1048576字 节；
● 支持配置为auto，此时obsutil会根据源对象大小自动设 置每个分段任务的段大小。
参数 约束 描述
cpd 附加参数，
可选 生成断点记录文件的文件夹，默认为运行obsutil命令 的用户目录的子文件夹.obsutil_checkpoint。
说明
每个分段复制任务会产生唯一对应的断点记录文件并保存 至该文件夹的copy子文件夹下，分段任务执行成功后，对 应的断点记录文件会被自动删除；分段任务执行失败或被 中断后，下次执行该分段任务时会尝试通过对应的断点记 录文件恢复任务。
f 附加参数，
可选
强制操作，不进行询问提示。
j 附加参数，
可选 批量复制任务的最大并发数，默认为配置文件中的 defaultJobs。
说明工具会保证该值至少为1。
exclude 附加参数，
可选
不包含源对象的匹配模式，如：*.txt。
说明
● 支持“*”匹配多个任意字符和“?”匹配单个任意字 符，例如abc*.txt代表匹配以abc开头以.txt结尾的任意 文件。
● 您可以使用“\*”代表匹配“*”字符本身，使用“\?”
代表匹配“?”字符本身。
● 如果待复制的对象名匹配该参数，则跳过该对象的复 制。
须知
● 建议使用引号传递该匹配模式（macOS/Linux操作系统 使用单引号，Windows操作系统使用双引号）防止特殊 符号被操作系统转义，导致不可预期的结果。
● 该匹配模式作用于对象全路径（含从根路径开始的对象 前缀和对象名，例如，桶内对象路径为obs://bucket/
src1/src2/test.txt，则对象的全路径为src1/src2/
test.txt）。
● 该匹配模式仅适用于对象名非“/”结尾的对象。
● 支持指定多个exclude参数，如exclude=*.xxx -exclude=*.xxx
参数 约束 描述 include 附加参数，
可选 包含源对象的匹配模式，如：*.jpg。
说明
● 支持“*”匹配多个任意字符和“?”匹配单个任意字 符。
● 您可以使用“\*”代表匹配“*”字符本身，使用“\?”
代表匹配“?”字符本身。
● 首先执行exclude的匹配规则，如果待复制的对象名不 匹配exclude，则判断待复制的对象名是否匹配该参 数，如果匹配则复制该对象，否则跳过该文件的复制。
须知
● 建议使用引号传递该匹配模式（macOS/Linux操作系统 使用单引号，Windows操作系统使用双引号）防止特殊 符号被操作系统转义，导致不可预期的结果。
● 该匹配模式作用于对象全路径（含从根路径开始的对象 前缀和对象名，例如，桶内对象路径为obs://bucket/
src1/src2/test.txt，则对象的全路径为src1/src2/
test.txt）。
● 该匹配模式仅适用于对象名非“/”结尾的对象。
● 支持指定多个include参数，如include=*.xxx -include=*.xxx
timeRange 附加参数，
可选
复制对象时的时间段匹配模式，仅复制最后修改时间 在该时间段内的对象。
该匹配模式优先级低于对象名匹配模式：exclude和 include，优先执行对象名匹配模式后才会执行该匹 配模式。
说明
● 使用“time1-time2”，代表匹配的时间段，其中time1 必须小于等于time2，格式为yyyyMMddHHmmss。
● 时间格式支持自动补全，例如yyyyMMdd等价于 yyyyMMdd000000，yyyyMM等价于
yyyyMM01000000。
● 使用“*-time2”，代表匹配最后修改时间在time2之前 的所有文件，使用“time1-*”，代表匹配最后修改时间 time1之后的所有文件。
须知
● 该匹配模式表示的时间是UTC时间。
● 该匹配模式仅适用于对象名非“/”结尾的对象。
mf 附加参数，
可选 设置名称匹配模式（include、exclude）和时间匹配 模式（timeRange）对对象名以“/”结尾的对象也 生效。
参数 约束 描述
● 结果清单文件命名规则：cp_{succeed | failed | warning}_report_时间_TaskId.txt。
config 附加参数，
可选
● Windows操作系统
obsutil cp -recover=xxx dryRun] tempFileDir=xxx] f] u] vlength] vmd5] j=1] p=1] threshold=52428800] ps=auto] include=*.xxx] exclude=*.xxx] timeRange=time1-time2] mf] [-o=xxx] [-cpd=xxx] [-clear] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]