简介

sync指令用来弥补fetch指令的不足之处。fetch指令适合于中小文件的抓取，根据实际经验，基本上适合50MB以下的文件抓取。但是很多场合，大的文件，比如1GB，100GB的文件想要直接从服务器迁移过来，就不能使用fetch功能，这个时候可以使用sync指令。

sync指令的基本原理是使用Range方式按照4MB一个块从资源服务器获取数据，然后使用七牛支持的分片上传功能直接传到七牛存储空间中。

另外sync指令在执行过程中，并不用担心网络中断导致的同步中断，因为采用了分片上传的机制，我们会把每一个成功上传的块的位置记录下来，当下次网络恢复的时候，只需要运行原始命令即可从断点处恢复。

格式

qshell sync <SrcResUrl> <Bucket> <Key> [<UpHostIp>]

需要在使用了account设置了AccessKey和SecretKey的情况下使用。

参数名	描述	可选参数
SrcResUrl	互联网上资源的链接，必须是可访问的链接	N
Bucket	空间名称，可以为公开空间或者私有空间	N
Key	该资源保存在空间中的名字	N
UpHostIp	上传入口的IP地址，一般在大文件的情况下，可以指定上传入口的IP来减少DNS环节，提升同步速度	Y

备注： 上传入口的域名对应的IP地址一般情况下是不变的，减少DNS的查询环节，可以提升同步速度和稳定性。上传入口的域名对应的IP地址可以通过如下的命令来获取解析的结果：

华东机房
$ dig up.qiniu.com

华北机房
$ dig up-z1.qiniu.com

华南机房
$ dig up-z2.qiniu.com

北美机房
$ dig up-na0.qiniu.com

抓取一个资源并以指定的文件名保存在七牛的空间里面：

$ qshell sync http://if-pbl.qiniudn.com/test_big_movie.mp4 if-pbl test.mp4