Object Storage Service:sync (Sinkronkan objek OSS ke komputer lokal)

Catatan penggunaan

• Operasi ini memerlukan izin oss:GetObject dan oss:ListObjects. Berikan izin kustom kepada RAM user.

• Nama biner

  Untuk ossutil 1.6.16 dan versi lebih baru, Anda dapat langsung menggunakan ossutil sebagai nama biner di command line tanpa perlu menyesuaikannya berdasarkan sistem operasi. Jika menggunakan versi ossutil sebelum 1.6.16, sesuaikan nama biner sesuai sistem operasi Anda. Untuk informasi selengkapnya, lihat Referensi perintah ossutil.

• Jumlah file

  Saat menjalankan perintah sync tanpa opsi --delete, tidak ada batasan jumlah file yang dapat disinkronkan sekaligus. Jika Anda menyertakan opsi --delete, Anda dapat menyinkronkan hingga 1 juta file sekaligus. Jika jumlah file yang akan disinkronkan melebihi 1 juta, error over max sync numbers 1000000. akan dikembalikan.

• Perbedaan dengan perintah cp

  • Perintah sync secara rekursif menelusuri semua objek dan subdirektori secara default. Perintah cp memerlukan opsi -r untuk operasi rekursif.

  • Perintah sync mendukung --backup-dir untuk menyimpan file yang hanya ada di tujuan ke folder backup. Perintah cp tidak mendukung --backup-dir.

  • Perintah sync tidak mendukung --version-id, sehingga tidak dapat menyinkronkan versi sebelumnya dari objek. Perintah cp mendukung --version-id.

  Perintah sync dan cp memiliki semua opsi lain yang sama. cp (Download file).

Format perintah

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

Parameter dan opsi:

Verifikasi hasil sinkronisasi

Verifikasi bahwa semua objek telah ditransfer dengan benar:

• Periksa jumlah file

  Bandingkan jumlah objek antara direktori OSS dan direktori lokal:

  # Hitung jumlah file di direktori lokal.
  ls -1 /local/dir/ | wc -l
  
  # Hitung jumlah objek di direktori OSS.  
  ossutil ls oss://bucket/dir/ -r | grep "^oss://" | wc -l

• Daftar objek yang disinkronkan

  Tinjau objek yang telah disinkronkan:

  # Daftar file lokal beserta ukurannya.
  ls -lh /local/dir/
  
  # Bandingkan dengan direktori OSS.
  ossutil ls oss://bucket/dir/ -r

Contoh

Contoh berikut menggunakan struktur file ini. Folder localdir di bucket OSS berisi a.txt, b.txt, dan subdirektori C. Folder lokal destdir berisi d.txt:

examplebucket           local root directory
└── localdir/             └── destdir/
       ├── a.txt                └── d.txt
       ├── b.txt
       └── C/

• Menyinkronkan folder localdir dari OSS ke komputer lokal Anda

  ossutil sync  oss://examplebucket/localdir/  destdir/ 

  Hasil: a.txt, b.txt, dan subdirektori C ditambahkan ke folder lokal destdir.

  examplebucket           local root directory
  └── localdir/             └── destdir/
         ├── a.txt                ├── a.txt 
         ├── b.txt                ├── b.txt
         └── C/                   ├── d.txt
                                     └── C/ 

• Menyinkronkan dengan --backup-dir: sinkronkan localdir dari examplebucket ke destdir lokal, dan pindahkan file yang hanya ada di tujuan ke folder backup.

  ossutil sync oss://examplebucket/localdir/  destdir/  --delete  --backup-dir backup/

  Hasil: folder localdir disinkronkan. File di destdir tetapi tidak ada di sumber dipindahkan ke folder backup. Folder lokal destdir hanya berisi a.txt, b.txt, dan subdirektori C. File asli d.txt dipindahkan ke folder backup.

  examplebucket              local root directory
  └── localdir/               ├── destdir/
         ├── a.txt            │     ├── a.txt 
         ├── b.txt            │     ├── b.txt
         └── C/               │     └── C/                             
                                 └── backup/
                                        └──d.txt

• Output sinkronisasi yang berhasil:

  Berhasil: Jumlah total: 2, ukuran: 750.081. Jumlah berhasil: 2(unggah 2 file).
  
  kecepatan rata-rata 1.641.000(byte/s)

Opsi umum

Untuk mengakses bucket di wilayah berbeda, gunakan -e untuk menentukan Titik akhir. Untuk mengakses bucket yang dimiliki oleh Akun Alibaba Cloud berbeda, gunakan -i untuk ID AccessKey dan -k untuk Rahasia AccessKey.

ossutil sync oss://examplebucket/srcfolder/  examplefolder/ -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Opsi umum.