sync（在OSS之间同步文件）

注意事项

• 要在OSS之间同步文件，您必须具有oss:GetObject、oss:ListObjects、oss:PutObject和oss:DeleteObject权限。具体操作，请参见为RAM用户授权自定义的权限策略。

• Binary名称

  从ossutil 1.6.16版本开始，命令行中Binary名称支持直接使用ossutil，您无需根据系统刷新Binary名称。如果您的ossutil版本低于1.6.16，则需要根据系统刷新Binary名称。更多信息，请参见命令行工具ossutil命令参考。

• 文件数量

  通过sync命令执行同步任务时，如果没有携带--delete选项，则单次同步任务同步的文件个数无限制。如果携带了--delete选项，则单次同步任务最多可同步100万个文件。当同步的文件个数超出100万时，将报错over max sync numbers 1000000.。

• sync命令与cp命令的区别

  • sync命令强制以递归的方式遍历指定文件夹内所有文件或子文件夹。cp命令需增加-r选项才会进行递归操作。

  • 通过sync命令将数据同步到OSS时，ossutil支持通过--delete选项将目标Bucket存在而源Bucket不存在的文件都删除，仅保留本次同步的文件。cp命令不支持--delete选项。

  • sync不支持--version-id选项，无法在已开启版本控制的Bucket内同步历史版本文件。cp命令支持--version-id选项。

  除以上区别外，sync命令与cp命令用法类似。关于cp命令的用法及示例，请参见cp（拷贝文件）。

使用限制

不支持将源Bucket中冷归档存储或者深度冷归档存储类型Object同步到目标Bucket。

命令格式

ossutil sync cloud_url cloud_url
[-f --force]
[-u --update]
[--delete]
[--enable-symlink-dir]
[--disable-all-symlink]
[--disable-ignore-error]
[--only-current-dir]
[--output-dir <value>]
[--bigfile-threshold <value>]
[--part-size <value>]
[--checkpoint-dir <value>]
[--encoding-type <value>]
[--include <value>]
[--exclude <value>]
[--meta <value>]
[--acl <value>]
[--maxupspeed <value>]
[--disable-crc64]
[--payer <value>]
[-j, --job <value>]
[--parallel <value>]
[--retry-times <value>]
[--tagging <value>]

参数及选项说明如下：

使用示例

examplebucket1          examplebucket2
├── exampledir/            └── destdir/
│      ├── a.txt               ├── c.txt
│      └── b.txt               └── e.txt
└── srcdir/     
        └── d.txt       

示例场景及命令如下：

• 将examplebucket1的exampledir文件夹同步到srcdir文件夹内。

  ossutil sync oss://examplebucket1/exampledir/  oss://examplebucket1/srcdir/

  命令执行完毕后，exampledir文件夹内的所有文件被同步到srcdir文件夹下。

  examplebucket1                    examplebucket1         
  ├── exampledir/                  ├── exampledir/
  │      ├── a.txt                 │      ├── a.txt 
  │      └── b.txt                 │      └── b.txt 
  └── srcdir/                      └── srcdir/    
          └── d.txt                        ├── a.txt
                                           ├── b.txt
                                           └── d.txt     

• 将examplebucket1的exampledir文件夹同步到examplebucket2的destdir文件夹。

  ossutil sync oss://examplebucket1/exampledir/ oss://examplebucket2/destdir/

  命令执行后，examplebucket1的exampledir文件夹中所有文件被同步到examplebucket2的destdir文件夹。

  examplebucket1          examplebucket2
  ├── exampledir/            └── destdir/
  │      ├── a.txt               ├── a.txt  
  │      └── b.txt               ├── b.txt
  └── srcdir/                     ├── c.txt 
          └── d.txt               └── e.txt

• 结合--delete选项将examplebucket1的所有文件同步到examplebucket2，并删除examplebucket2存在而examplebucket1不存在的文件。

  ossutil sync oss://examplebucket1 oss://examplebucket2 --delete

  命令执行后，examplebucket1中的文件将同步到examplebucket2，examplebucket2内已有的文件c.txt和e.txt将被删除。

  examplebucket1          examplebucket2
  ├── exampledir/            ├── exampledir/
  │      ├── a.txt           │      ├── a.txt  
  │      └── b.txt           │      └── b.txt
  └── srcdir/                └── srcdir/  
          └── d.txt                  └── d.txt                  

• 以上示例同步成功后，返回结果中将包含同步的文件数量、文件大小以及完成同步操作所用时长，示例如下：

  Succeed: Total num: 2, size: 750,081. OK num: 2(upload 2 files).
  
  average speed 1641000(byte/s)

通用选项

当您需要通过命令行工具ossutil切换至另一个地域的Bucket时，可以通过-e选项指定该Bucket所属的Endpoint。当您需要通过命令行工具ossutil切换至另一个阿里云账号下的Bucket时，可以通过-i选项指定该账号的AccessKey ID，并通过-k选项指定该账号的AccessKey Secret。

ossutil sync oss://examplebucket/srcfolder/  oss://testbucket/examplefolder/ -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA****  -k 67DLVBkH7EamOjy2W5RVAHUY9H****

关于此命令的其他通用选项的更多信息，请参见通用选项。