Object Storage Service:sync (Synchronize OSS objects to a local computer)

Remarques sur l'utilisation

• Cette opération nécessite les autorisations oss:GetObject et oss:ListObjects. Accorder des autorisations personnalisées à un utilisateur RAM.

• Nom du binaire

  Pour ossutil 1.6.16 et versions ultérieures, vous pouvez utiliser ossutil directement comme nom de binaire dans la ligne de commande. Il n'est pas nécessaire de modifier le nom du binaire en fonction du système d'exploitation. Si vous utilisez une version d'ossutil antérieure à la 1.6.16, adaptez le nom du binaire à votre système d'exploitation. Pour plus d'informations, consultez la page Référence des commandes ossutil.

• Nombre de fichiers

  Lorsque vous exécutez la commande sync sans l'option --delete, il n'y a aucune limite au nombre de fichiers que vous pouvez synchroniser en une seule fois. Si vous incluez l'option --delete, vous pouvez synchroniser jusqu'à 1 million de fichiers à la fois. Si le nombre de fichiers à synchroniser dépasse 1 million, l'erreur over max sync numbers 1000000. est renvoyée.

• Différences avec la commande cp

  • Par défaut, la commande sync parcourt de manière récursive tous les objets et sous-répertoires. La commande cp nécessite l'option -r pour les opérations récursives.

  • La commande sync prend en charge l'option --backup-dir afin d'enregistrer les fichiers présents uniquement dans la destination vers un dossier de sauvegarde. La commande cp ne prend pas en charge l'option --backup-dir.

  • La commande sync ne prend pas en charge l'option --version-id ; elle ne peut donc pas synchroniser les versions précédentes des objets. La commande cp prend en charge l'option --version-id.

  Les commandes sync et cp partagent toutes les autres options. Consultez la page cp (Télécharger des fichiers).

Format de la commande

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>]

Paramètres et options :

Vérifier les résultats de la synchronisation

Vérifiez que tous les objets ont été transférés correctement :

• Vérifier le nombre de fichiers

  Comparez le nombre d'objets entre OSS et les répertoires locaux :

  # Count files in the local directory.
  ls -1 /local/dir/ | wc -l
  
  # Count objects in the OSS directory.  
  ossutil ls oss://bucket/dir/ -r | grep "^oss://" | wc -l

• Lister les objets synchronisés

  Consultez les objets synchronisés :

  # List local files with sizes.
  ls -lh /local/dir/
  
  # Compare with the OSS directory.
  ossutil ls oss://bucket/dir/ -r

Exemples

Les exemples suivants utilisent cette structure de fichiers. Le dossier localdir du bucket OSS contient a.txt, b.txt et le sous-répertoire C. Le dossier local destdir contient d.txt :

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

• Synchronisez le dossier localdir depuis OSS vers votre ordinateur local

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

  Résultat : a.txt, b.txt et le sous-répertoire C sont ajoutés au dossier local destdir.

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

• Synchronisation avec l'option --backup-dir : synchronisez localdir depuis examplebucket vers le dossier local destdir et déplacez les fichiers présents uniquement dans la destination vers le dossier backup.

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

  Résultat : le dossier localdir est synchronisé. Les fichiers présents dans destdir mais absents de la source sont déplacés vers le dossier backup. Le dossier local destdir ne contient plus que a.txt, b.txt et le sous-répertoire C. Le fichier d.txt d'origine est déplacé vers le dossier backup.

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

• Sortie en cas de synchronisation réussie :

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

Options courantes

Pour accéder à un bucket situé dans une autre région, utilisez -e pour spécifier l'endpoint. Pour accéder à un bucket appartenant à un autre compte Alibaba Cloud, utilisez -i pour l'AccessKey ID et -k pour l'AccessKey Secret.

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

Options courantes.