功能说明
移动对象或按对象名前缀批量移动对象。
须知
● 移动对象时，请确保OBS桶中的源对象不发生变化，否则可能产生移动失败或者数 据不一致的问题。
● 如果被移动对象的存储类型为cold，必须首先恢复被移动对象，否则无法移动成 功。
● 移动对象或批量移动成功后，源端对象会被删除。
● 如果源桶是并行文件系统（POSIX），则目标桶不能是对象存储桶。
命令结构
● Windows操作系统 – 移动单个对象
obsutil mv obs://srcbucket/key obs://dstbucket/[dest] dryRun] u] 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 mv obs://srcbucket[/key] obs://dstbucket[/dest] -r dryRun] f] flat] u] 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 mv obs://srcbucket/key obs://dstbucket/[dest] dryRun] u] 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 mv obs://srcbucket[/key] obs://dstbucket[/dest] -r dryRun] f] flat] u] 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 mv obs://bucket-test/key obs://
bucket-test2 ，移动单个对象。
obsutil mv 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 Move successfully, 19B, obs://bucket-test/key --> obs://bucket-test2/key
ext.txt
● 以Windows操作系统为例，运行obsutil mv obs://bucket-test/temp/ obs://
bucket-test2 -f -r，批量移动对象。
obsutil mv obs://bucket-test/temp/ obs://bucket-test2 -f -r 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 附加参数，
可选
参数 约束 描述 threshold 附加参数，
可选
● 支持带容量单位配置，例如，配置1MB代表1048576字 节。
versionId 附加参数，
移动对象时 可选
移动单个对象时可指定的源对象版本号。
说明POSIX桶无version概念，故POSIX桶不支持versionId选项。
acl 附加参数，
可选
移动对象时可指定的目标对象的预定义访问策略。支 持的值：
● private
● public-read
● public-read-write
● bucket-owner-full-control 说明
● 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）对对象名以“/”结尾的对象也 生效。
参数 约束 描述
o 附加参数，
可选
生成结果清单文件的文件夹，命令执行完成后，会在 该文件夹下生成结果清单文件（可能包含成功结果、
失败结果和警告结果三个文件），默认为运行obsutil 命令的用户目录的子文件夹.obsutil_output。
说明
● 结果清单文件命名规则：mv_{succeed | failed | warning}_report_时间_TaskId.txt。
● 单个结果清单文件默认情况下最大为30MB且最大可保 留的文件个数为1024，可在配置文件中通过
recordMaxLogSize和recordBackups分别配置。
● 当涉及多文件/文件夹时，如需确认失败任务的具体错误 信息，可参考结果清单文件夹下的失败结果清单文件
"mv_failed_report_时间_TaskId.txt"及日志路径下的日 志文件；
config 附加参数，
可选
运行当前命令时的自定义配置文件，可支持的配置参 数请参考配置参数说明。
e 附加参数，
可选
指定终端节点。
i 附加参数，
可选 指定用户的AK。
k 附加参数，
可选 指定用户的SK。
t 附加参数，
可选
指定用户的securitytoken。
响应结果
请参考上传对象的响应结果。