sync

注意事项

除以上区别外，sync命令支持cp命令的所有用法。cp命令使用方法请参见cp。

同步本地文件到OSS

• 命令格式

  ./ossutil sync file_url cloud_url  [-f] [-u] [--delete] [--backup-dir] [--enable-symlink-dir] [--disable-all-symlink] [--disable-ignore-error] [--only-current-dir] [--output-dir=odir] [--bigfile-threshold=size] [--checkpoint-dir=cdir] [--snapshot-path=sdir] [--payer requester]

  参数说明：
  • file_url：本地文件夹路径。例如Linux系统文件路径/localfolder/；Windows系统文件路径D:\localfolder\。
  • cloud_url：OSS文件夹（文件目录）路径，格式为oss://bucketname/path/。例如oss://examplebucket/exampledir/。如果输入的cloud_url没有以正斜线（/）结尾，ossutil会自动在结尾处添加一个正斜线（/）。
• 使用示例
  OSS端名为examplebucket的Bucket下example文件夹内有文件a.txt、b.txt以及子文件夹C，本地端根目录下example文件夹内有d.txt文件。文件结构如下：

  examplebucket           本地根目录
  └── example/             └── example/
         ├── a.txt                └── d.txt
         ├── b.txt
         └── C/

  示例场景及命令如下：

  • 将本地example文件夹同步到OSS

    ./ossutil sync example/  oss://examplebucket/example/

    命令执行完毕后，examplebucket的example文件夹内新增d.txt文件。

    examplebucket           本地根目录
    └── example/             └── example/
           ├── a.txt                └── d.txt
           ├── b.txt
           ├── d.txt
           └── C/

  • 同步本地文件夹到OSS，并省略问询操作
    同步本地文件夹到OSS时，若目的端存在同名文件，ossutil会进行覆写操作的问询。若您确认目的端文件均可被覆写，可增加-f，--force选项强制执行覆写操作。命令如下：

    ./ossutil sync localfolder/ oss://examplebucket/destfolder/ -f

    命令执行完毕后，examplebucket的example文件夹内新增d.txt文件。

    examplebucket           本地根目录
    └── example/             └── example/
           ├── a.txt                └── d.txt
           ├── b.txt
           ├── d.txt
           └── C/

  • 同步本地文件夹到OSS，并删除OSS指定路径下已有而本地端没有的文件
    当同步数据的目的端为OSS时，可增加--delete，将目的端存在而源端不存在的文件都删除，仅保留本次同步的文件。

    ./ossutil sync example/  oss://examplebucket/example/ --delete

    命令执行完成后，本地端的example文件夹被同步到OSS端，同时会删除OSS端的文件a.txt、b.txt以及子文件夹C，即OSS端的example文件夹内仅保留d.txt文件。

    examplebucket           本地根目录
    └── example/             └── example/
           └── d.txt                └── d.txt

同步OSS文件到本地

• 命令格式

  ./ossutil sync cloud_url file_url  [-f] [-u] [--delete] [--backup-dir] [--only-current-dir] [--disable-ignore-error] [--output-dir=odir] [--bigfile-threshold=size] [--checkpoint-dir=cdir] [--range=x-y] [--payer requester]

  使用sync命令将OSS文件同步到本地，其中：
  • file_url：本地文件夹路径。例如Linux系统文件路径/localfolder/；Windows系统文件路径D:\localfolder\。
  • cloud_url：OSS文件夹路径，格式为oss://bucketname/path/。例如oss://examplebucket/exampledir/。
• 使用示例
  OSS端名为examplebucket的Bucket下example文件夹内有文件a.txt、b.txt以及子文件夹C，本地端根目录下example文件夹内有d.txt文件。文件结构如下：

  examplebucket           本地根目录
  └── example/             └── example/
         ├── a.txt                └── d.txt
         ├── b.txt
         └── C/

  示例场景及命令如下：

  • 将OSS的example文件夹同步到本地

    ./ossutil sync  oss://examplebucket/example/  example/ 

    命令执行完毕后，本地example文件夹内新增a.txt、b.txt以及子文件夹C。

    examplebucket           本地根目录
    └── example/             └── example/
           ├── a.txt                ├── a.txt 
           ├── b.txt                ├── b.txt
           └── C/                   ├── d.txt
                                       └── C/ 

  • 将OSS端example文件夹同步到本地，并迁移本地端指定路径下已有而OSS端没有的文件到backup文件夹

    ./ossutil sync oss://examplebucket/example/  example/  --delete  --backup-dir backup/

    命令执行完毕后，OSS端的example文件夹被同步到本地，同时本地example文件夹内原有的文件被迁移到backup文件夹内。即本地example文件夹仅保存a.txt、b.txt及子文件夹C，backup文件夹内新增d.txt文件。

    examplebucket           本地根目录
    └── example/             ├── example/
           ├── a.txt         │     ├── a.txt 
           ├── b.txt         │     ├── b.txt
           └── C/            │     └── C/                             
                                └── backup/
                                       └──d.txt

在OSS之间同步文件

• 命令格式

  ./ossutil sync cloud_url cloud_url [-f] [-u] [--delete] [--backup-dir] [--only-current-dir] [--disable-ignore-error] [--output-dir=odir] [--bigfile-threshold=size] [--checkpoint-dir=cdir] [--payer requester]

  使用sync命令在OSS之间同步数据，同步的源和目的需在同一个地域。cloud_url为OSS文件夹路径，格式为oss://bucketname/path/。例如oss://examplebucket/exampledir/。
• 使用示例
  某阿里云账号下有examplebucket1和examplebucket2两个Bucket，examplebucket1下有example和test两个文件夹；examplebucket2下有example文件夹。文件结构如下：

  examplebucket1          examplebucket2
  ├── example/            └── example/
  │      ├── a.txt               ├── a.txt
  │      └── b.txt               └── c.txt
  └── test/     
          └── d.txt       

  示例场景及命令如下：

  • 将examplebucket1的example文件夹同步到test文件夹内

    ./ossutil sync oss://examplebucket1/example/  oss://examplebucket1/test/

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

    examplebucket1          examplebucket2
    ├── example/            └── example/
    │      ├── a.txt               ├── a.txt
    │      └── b.txt               └── c.txt
    └── test/        
            ├── a.txt
            ├── b.txt
            └── d.txt      

  • 将examplebucket1的example文件夹同步到examplebucket2的example文件夹

    ./ossutil sync oss://examplebucket1/example/ oss://examplebucket2/example/

    命令执行完毕后examplebucket1的example文件夹中所有文件被同步到examplebucket2的example文件夹。

    examplebucket1          examplebucket2
    ├── example/            └── example/
    │      ├── a.txt               ├── a.txt  
    │      └── b.txt               ├── b.txt
    └── test/                       └── c.txt 
            └── d.txt

  • 将examplebucket1的所有文件同步到examplebucket2内，并删除examplebucket2有而examplebucket1没有的文件

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

    命令执行完毕后，examplebucket1的example和test文件夹被同步到examplebucket2根目录，examplebucket2内其他文件被删除。

    examplebucket1          examplebucket2
    ├── example/            ├── example/
    │      ├── a.txt       │      ├── a.txt  
    │      └── b.txt       │      └── b.txt
    └── test/               └── test/  
            └── d.txt               └── d.txt                  

常用选项