功能说明
复制对象或按对象名前缀批量复制对象。
须知
● 复制对象或批量复制时，请确保OBS桶中的源对象不发生变化，否则可能产生复制 失败或者数据不一致的问题。
● 如果被复制对象的存储类型为cold，必须首先恢复被复制对象，否则无法复制成 功。
● 复制时需要有被复制对象的读权限和目标桶的写权限。
● 如果没有开启客户端跨区域复制模式，复制的源桶和目标桶必须在同一个区域
（Region）。
● 如果源桶是并行文件系统（POSIX），则目标桶不能是非并行文件系统。
命令结构
● Windows操作系统 – 复制单个对象
obsutil cp obs://srcbucket/key obs://dstbucket/[dest] dryRun]u] crr] vlength] vmd5] p=1] threshold=52428800] versionId=xxx] acl=xxx] sc=xxx] meta=aaa:bbb#ccc:ddd] [-ps=auto] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
– 批量复制对象
obsutil cp obs://srcbucket[/key] obs://dstbucket[/dest] -r dryRun]f] flat] 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] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
● macOS/Linux操作系统 – 复制单个对象
./obsutil cp obs://srcbucket/key obs://dstbucket/[dest] dryRun] u] crr] vlength] vmd5] p=1] threshold=52428800] versionId=xxx] acl=xxx] sc=xxx] meta=aaa:bbb#ccc:ddd] [-ps=auto] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
– 批量复制对象
./obsutil cp obs://srcbucket[/key] obs://dstbucket[/dest] -r dryRun] f] flat] 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] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
说明
● 复制的源路径和目标路径不能完全相同。
● 批量复制时，源路径和目标路径不能相互嵌套（目标路径以源路径为前缀时，可能会产生递 归复制；源路径以目标路径为前缀时，可能会产生覆盖拷贝）。
运行示例
● 以Windows操作系统为例，运行obsutil cp obs://bucket-test/key obs://
bucket-test2 ，复制单个对象。
obsutil cp obs://bucket-test/key obs://bucket-test2 Parallel: 3 Jobs: 3
Threshold: 524288000 PartSize: 5242880 Exclude: Include:
VerifyLength: false VerifyMd5: false CheckpointDir: xxxx
[=====================================================] 100.00% 6/s 0s Copy successfully, 19B, obs://bucket-test/key --> obs://bucket-test2/key
ext.txt
● 以Windows操作系统为例，运行obsutil cp obs://bucket-test/temp/ obs://
bucket-test2 -f -r，批量复制对象。
obsutil cp obs://bucket-test/temp/ obs://bucket-test2 -r -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: 5 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: 0476929d-9d23-4dc5-b2f8-0a0493f027c5
● 更多运行示例，请参见复制示例。
参数说明
参数 约束 描述
srcbucket 必选 源桶名。
dstbucket 必选 目标桶名。
dest 可选 复制对象时的目标对象名，或批量复制时目标对象名 前缀。
参数 约束 描述
– 如果dest以“/”结尾，目标对象名为dest+源 对象名；
– 如果dest不以“/”结尾，目标对象名为dest +/+源对象名。
dryRun 附加参数，
可选
vlength 附加参数，
可选
复制完成后，验证目标桶对象大小是否与源桶中对象 的大小一致。
说明必须与crr参数配合使用。
参数 约束 描述
● 源桶中对象必须包含元数据x-obs-md5chksum，否则会 忽略MD5值校验。
threshold 附加参数，
可选
● 支持带容量单位配置，例如，配置1MB代表1048576字 节。
versionId 附加参数，
复制对象时
● private
● public-read
● public-read-write
● bucket-owner-full-control 说明
以上四个值分别对应：私有读写、公共读、公共读写、桶 拥有者完全控制，四种预定义访问策略。
参数 约束 描述
sc 附加参数，
可选
复制对象时可指定的目标对象的存储类型。支持的 值：
● standard：标准存储，访问时延低、吞吐量高，
适用于有大量热点文件（平均一个月多次）或小 文件（小于1MB）。
● warm：低频访问存储，可用性略低于standard，
适用于不频繁访问（平均一年少于12次）但在需
● 支持带容量单位配置，例如，配置1MB代表1048576字 节。
● 支持配置为auto，此时obsutil会根据源对象大小自动设 置每个分段任务的段大小。
cpd 附加参数，
可选 生成断点记录文件的文件夹，默认为运行obsutil命令 的用户目录的子文件夹.obsutil_checkpoint。
参数 约束 描述 exclude 附加参数，
批量复制时
● 建议使用引号传递该匹配模式（ macOS/Linux操作系统 使用单引号，Windows操作系统使用双引号）防止特殊
● 支持指定多个exclude参数，如 exclude=*.xxx -exclude=*.xxx
include 附加参数，
批量复制时
● 首先执行exclude的匹配规则，如果待复制的对象名不 匹配exclude，则判断待复制的对象名是否匹配该参 数，如果匹配则复制该对象，否则跳过该文件的复制。
须知
● 建议使用引号传递该匹配模式（macOS/Linux操作系统 使用单引号，Windows操作系统使用双引号）防止特殊
● 支持指定多个include参数，如include=*.xxx -include=*.xxx
参数 约束 描述 timeRange 附加参数，
批量复制时
● 使用“time1-time2”，代表匹配的时间段，其中time1 必须小于等于time2，格式为yyyyMMddHHmmss。
● 时间格式支持自动补全，例如yyyyMMdd等价于 yyyyMMdd000000，yyyyMM等价于
yyyyMM01000000。
● 使用“*-time2”，代表匹配最后修改时间在time2之前 的所有文件，使用“time1-*”，代表匹配最后修改时间
可选 设置名称匹配模式（include、exclude）和时间匹配 模式（timeRange）对对象名以“/”结尾的对象也
● 结果清单文件命名规则：cp_{succeed | failed | warning}_report_时间_TaskId.txt。
config 附加参数，
可选
可选 指定用户的securitytoken。
响应结果
请参考上传对象的响应结果。