注意事項

• 要將本地文件同步到OSS，您必須具有oss:PutObject、oss:ListObjects和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選項將目的端存在而源端不存在的文件都刪除，僅保留本次同步的文件。cp命令不支持--delete選項。

  • sync不支持--version-id選項，無法在已開啟版本控制的Bucket內同步歷史版本文件。cp命令支持--version-id選項。

  除以上區別外，sync命令與cp命令用法類似。有關cp命令的用法及示例，請參見cp（上傳文件）。

命令格式

ossutil sync file_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>]
[--snapshot-path <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>]

參數及選項說明如下：

使用示例

本地根目錄下localfolder文件夾內有d.txt和e.png文件。OSS中名為examplebucket的Bucket下文件夾destfolder內有文件a.txt、b.txt和子文件夾C，文件結構如下：

本地根目錄                  examplebucket
    └── localfolder         └── destfolder/
            ├── d.txt               ├── a.txt
            ├── e.png               ├── b.txt
                                    └── C/

示例場景及命令如下：

• 將本地localfolder文件夾同步到OSS

  ossutil sync localfolder/  oss://examplebucket/destfolder/

  命令執行后，examplebucket的 destfolder文件夾內新增d.txt和e.png文件。

  本地根目錄                  examplebucket
      └── localfolder         └── destfolder/
              ├── d.txt               ├── a.txt
              ├── e.png               ├── b.txt
                                      ├── d.txt 
                                      ├── e.png 
                                      └── C/
                          

• 將本地localfolder文件夾的.txt文件同步到OSS

  ossutil sync localfolder/  oss://examplebucket/destfolder/ --include "*.txt"

  命令執行后，examplebucket的 destfolder文件夾內新增d.txt文件。

  本地根目錄                  examplebucket
      └── localfolder         └── destfolder/
              ├── d.txt               ├── a.txt
              ├── e.png               ├── b.txt
                                      ├── d.txt 
                                      └── C/
                          

• 將本地localfolder文件夾的非.txt文件同步到OSS

  ossutil sync localfolder/  oss://examplebucket/destfolder/ --exclude "*.txt"

  命令執行后，examplebucket的destfolder文件夾內新增e.png文件。

  本地根目錄                  examplebucket
      └── localfolder         └── destfolder/
              ├── d.txt               ├── a.txt
              ├── e.png               ├── b.txt
                                      ├── e.png 
                                      └── C/
                          

• 同步本地文件夾到OSS，并刪除OSS指定路徑下已存在而本地端不存在的文件

  通過增加--delete選項，刪除目的端存在而源端不存在的文件，僅保留本次同步的文件。

  ossutil sync localfolder/  oss://examplebucket/destfolder/ --delete

  命令執行后，本地localfolder文件夾被同步到OSS，同時會刪除OSS的文件a.txt、b.txt以及子文件夾C，即OSS的destfolder文件夾內僅保留d.txt和e.png文件。

  本地根目錄                  examplebucket
      └── localfolder         └── destfolder/
              ├── d.txt                ├── d.txt
              ├── e.png                ├── e.png 

• 同步本地文件夾到OSS，并省略問詢操作

  默認情況下，同步本地文件夾到OSS時，如果目的端存在同名文件，ossutil會進行覆寫操作的問詢。命令如下：

  ossutil sync localfolder/ oss://examplebucket/destfolder/
  cp: overwrite "oss://examplebucket/destfolder/d.txt"(y or N)?

  如果您確認目的端文件均可被覆寫，可增加-f，--force選項強制執行覆寫操作。命令如下：

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

  命令執行后，examplebucket的destfolder文件夾內新增d.txt和e.png文件。

  本地根目錄                  examplebucket
      └── localfolder         └── destfolder/
              ├── d.txt               ├── a.txt
              ├── e.png               ├── b.txt
                                      ├── d.txt 
                                      ├── e.png
                                      └── C/
                      

• 以上示例同步成功后，返回結果中將包含同步的文件數量、文件大小以及完成同步操作所用時長，示例如下：

  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 srcfolder/ oss://examplebucket/testfolder/ -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA****  -k 67DLVBkH7EamOjy2W5RVAHUY9H****

關于此命令的其他通用選項的更多信息，請參見通用選項。