Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Transférer des fichiers à l'aide de l'interface de ligne de commande (CLI)
Les sections suivantes expliquent comment charger, télécharger et configurer des hot folders à l'File Transferaide de l'interface de ligne de commande (CLI).
**Topics**
+ [Chargement de fichiers](#upload-cli)
+ [Configuration des hot folders](#hot-folders-file-transfer-cli)
+ [Télécharger des fichiers](#download-cli)
## Chargement de fichiers
Les commandes suivantes concernent l'interface de ligne de commande (CLI). Ces commandes vous permettent de télécharger des fichiers depuis le compartiment S3 correspondant que vous avez configuré dans votre fichier de configuration. Vous pouvez exécuter ces commandes depuis n'importe quel emplacement de votre ordinateur. Cependant, nous vous recommandons d'exécuter ces commandes depuis root.
File Transferpréserve la structure de dossiers que vous lui donnez. Cela signifie que la structure du dossier reste la même une fois qu'il atteint Amazon S3. Cependant, vous ne pouvez pas donner de chemin File Transfer absolu. Cela signifie que le chemin du fichier ne peut pas commencer par une `/` (barre oblique).
File Transfertéléchargements vers toutes les classes de stockage S3. Pour plus d'informations sur les classes de stockage, consultez [Classes de stockage Amazon S3](https://aws.amazon.com/s3/storage-classes/).
**Note**
Nous vous recommandons de désactiver le mode veille sur votre ordinateur local. Si votre ordinateur active le mode veille, les transferts en cours peuvent être interrompus. Dans **Réglages**, activez l'option **Désactiver le mode veille (macOS uniquement).**
**Pour démarrer les téléchargements à l'aide de la CLI**
1. Ouvrez un terminal .
1. (Recommandé) Accédez au dossier contenant les fichiers et dossiers que vous souhaitez télécharger.
1. Exécutez la commande suivante depuis n'importe où sur votre ordinateur pour télécharger des fichiers depuis votre machine locale vers Amazon S3.
```
filetransfer upload [transfer profile] [relative path]
```
1. Remplacez *[profil de transfert]* par le profil de transfert que vous souhaitez utiliser.
1. Remplacez *[chemin relatif]* par le chemin du fichier ou du répertoire que vous souhaitez télécharger.
1. Un chemin relatif ne commence pas par une `/` (barre oblique). Exemple : `Users/username/Desktop/folder1`
1. N'utilisez pas de chemin absolu. Un chemin de fichier absolu commence par une `/` (barre oblique). Exemple : `/Users/username/Desktop/folder1`
1. Exemple de commande : `filetransfer upload [transfer profile name] /Users/username/Desktop/folder1`
File Transferfonctionne [File Transfersommes de contrôle](checksums.md) sur vos fichiers. La somme de contrôle est utilisée pour une vérification supplémentaire de l'intégrité des fichiers, afin de détecter si un fichier a été modifié de manière inattendue. Une fois ces checksums terminés, les transferts commencent. Si vous fournissez votre propre *liste de hachage multimédia* (*MHL*), vous File Transfer pouvez vérifier que vos fichiers correspondent à la somme de contrôle définie dans la MHL. Le MHL est un fichier XML qui contient souvent des séquences de caméra brutes.
### Indicateurs
Pour effectuer certaines actions, vous pouvez ajouter des drapeaux à la fin d'une commande. L'utilisation de drapeaux est facultative.
| Indicateur | Description | Exemple |
| --- | --- | --- |
| --help | Répertoriez les drapeaux et les commandes disponibles. | `filetransfer --help` |
| --checksum - algorithme | Définissez le calcul File Transfer de la somme de contrôle effectué. Valeurs prises en charge : `md5``XXHash`,`XXHash64`, et`XXH3`. | `filetransfer upload [remote configuration] [relative path] –-checksum-algorithm xxhash64` |
| --enable-metadata-filter | Lorsqu'il est utilisé, File Transfer filtre automatiquement les fichiers de métadonnées du système. Ces fichiers incluent `Thumbs.db``.DS_Store`, et les fichiers commençant par `._.` | `filetransfer upload [remote configuration] [relative path] --enable-metadata-filter` |
| --filtre | Filtrez les fichiers transférés en fonction de leur format. Le champ de filtre accepte les expressions régulières valides. Exemple : transfère `^.*\.(mov)$` uniquement les fichiers se terminant par`.mov`. Des filtres peuvent être ajoutés au fichier de configuration pour effectuer certaines actions. Lorsque vous ajoutez des filtres à la configuration au lieu de les utiliser comme indicateurs sur des commandes spécifiques, File Transfer applique l'action à tous les transferts. | `filetransfer upload [remote configuration] [relative path] --filter "^.*\.(mov)$"` Cette commande ne téléchargera que les fichiers au `.mov` format. |
| --force | Forcez un transfert indépendamment des filtres ou des conflits. Par défaut, les fichiers précédemment transférés File Transfer ne seront pas transférés. Le drapeau de force fait File Transfer ignorer les filtres ou les conflits. Cette fonction est utile si vous avez accidentellement supprimé un fichier à télécharger. | `filetransfer upload [remote configuration] [relative path] --force` |
| --âge maximal | Transférez uniquement les fichiers créés ou modifiés au cours d'une période se terminant à l'heure actuelle. Si aucune unité n'est fournie, l'âge maximum sera exprimé en secondes. Par exemple, `2d` téléchargera les fichiers des deux derniers jours et `3500` téléchargera les fichiers des 3500 dernières secondes. | `filetransfer upload [remote configuration] [relative path] --max-age “2d”` La commande ci-dessus ne téléchargera dans le compartiment S3 que les fichiers des 2 derniers jours. |
| --nombre de réessais | En cas d'erreur, File Transfer tentera de transférer vos fichiers autant de fois que le nombre de nouvelles tentatives sera atteint. | `filetransfer upload [remote configuration] [relative path] --retry-count 4` |
| --taille du morceau | Taille du morceau en Mo (25 par défaut) | `filetransfer upload [remote configuration] [relative path] --chunk-size 50` |
| --réglage automatique | Permettre à l'outil de déterminer les meilleures valeurs de configuration pour optimiser le transfert | `filetransfer upload [remote configuration] [relative path] --auto-tuning true` |
| --max-active-checksums | Nombre maximum de checksums actifs (1 par défaut). Ce drapeau n'est valable que pour les téléchargements. | `filetransfer upload [remote configuration] [relative path] --max-active-checksums 5` |
| --max-active-transfers | Nombre maximum de transferts | `filetransfer upload [remote configuration] [relative path] --max-active-transfers 10` |
| --préfixe | Chemin du préfixe S3 pour les chargements et les téléchargements | `filetransfer upload [remote configuration] [relative path] --prefix my/s3/path` |
| --profile | AWS profil nommé | `filetransfer upload [remote configuration] [relative path] --profile my_named_profile` |
| --fils | Nombre de fils par téléchargement (10 par défaut) | `filetransfer upload [remote configuration] [relative path] --threads 10` |
| FILETRANSFER\$1CONFIG\$1DIR | Remplace le `.filetransfer` dossier par défaut. Cette variable peut définir n'importe quel répertoire pour stocker le fichier de configuration et le fichier de base de données. Si `FILETRANSFER_CONFIG_DIR` ce n'est pas le cas`~/.filetransfer`, la valeur par défaut est utilisée. Les fichiers doivent toujours être nommés `configuration.yaml` ou`configuration.yaml`, et`checksum-cache.db`. S'ils n'existent pas, ils sont créés. | `FILETRANSFER_CONFIG_DIR=Desktop/config1 filetransfer upload [remote configuration] [relative path]` |
## Configuration des hot folders
**Pour configurer le hot folder de téléchargement à l'aide de la CLI.**
1. Ouvrez le fichier de configuration avec n'importe quel logiciel d'édition de texte installé sur votre ordinateur.
1. Windows : accédez au `User/` dossier sur votre ordinateur. Ouvrez le `.filetransfer` dossier et ouvrez le `filetransfer.yaml` fichier dans un éditeur de texte.
1. macOS: Entrez**Cmd\$1Shift\$1G**. Entrez ensuite**\$1/.filetransfer**. Ouvrez le fichier `filetransfer.yaml` avec un éditeur de texte.
1. Linux : ouvrez le `filetransfer.yaml` fichier à l'aide de n'importe quel éditeur de texte. Le fichier se trouve dans`~/.filetransfer/configuration.yaml`.
1. Créez une nouvelle `hot_folder` section avec les champs suivants
```
hot folders:
- enabled: true
local_source_folder: /Users/user/myhotfolder
name: my_hot_folder
remote_configurations:
- remote_configuration_name: example_configuration
s3_destination_folder: my/s3/prefix
```
1. Le hot folder ne sera actif que `enabled` s'il est défini sur true.
1. Remplacez *local\$1source\$1folder* par l'emplacement du dossier que vous souhaitez surveiller. File Transfer Le chemin du fichier doit contenir le chemin complet : `C:\path\to\upload-hot-folder` (Windows) ou `/path/to/upload-hot-folder` (Linux&macOS).
1. Sous `remote_configurations` :
1. Remplacez *remote\$1configuration\$1name par le nom* de la configuration distante que vous souhaitez utiliser. Vous trouverez les configurations de votre télécommande dans la liste ci-dessous`protocols.s3.transfer_profiles`.
1. (Facultatif) Remplacez *s3\$1destination\$1folder* par le dossier de destination S3 dans lequel vous souhaitez télécharger les fichiers. File Transfercréera le dossier dans Amazon S3 s'il n'existe pas déjà. Les fichiers seront placés à la racine du compartiment si la valeur n'est pas définie.
1. (Facultatif) Vous pouvez ajouter ici autant d'entrées de configuration à distance que vous le souhaitez, et le hot folder lancera un téléchargement à l'aide de chaque configuration à distance. Cela vous permet de définir un seul hot folder qui sera chargé dans plusieurs compartiments.
1. L'exemple suivant est une configuration de hot folder de téléchargement avec plusieurs hot folders. Dans cet exemple, il existe deux dossiers actifs.
1. Le premier hot folder est configuré pour surveiller le `Media/drive` dossier. Lorsque des fichiers sont ajoutés à ce dossier, deux téléchargements démarrent, l'un utilisant la configuration `example1` à distance et l'autre utilisant la configuration `example2` à distance. Chaque téléchargement utilisera son équivalent`s3_destination_folder`.
1. Le deuxième hot folder est configuré pour surveiller le `/Users/user1/myhotfolder` dossier. Lorsque des fichiers sont ajoutés à ce dossier, un seul téléchargement est lancé, en utilisant la configuration `another_configuration` à distance. Tous les fichiers seront chargés dans le `example_folder` dossier d'Amazon S3.
```
hot folders:
- enabled: true
local_source_folder: /Media/drive
name: my_hot_folder
remote_configurations:
- remote_configuration_name: example1
s3_destination_folder: my/s3/folder
- remote_configuration_name: example2
s3_destination_folder: second/folder
- enabled: true
local_source_folder: /Users/user1/my_hot_folder
name: another_hot_folder
remote_configurations:
- remote_configuration_name: another_configuration
s3_destination_folder: example/folder
```
1. Enregistrez le fichier de configuration.
**Note**
Lorsque vous démarrez le daemon ou lorsque des dossiers actifs sont ajoutés/mis à jour, un téléchargement forcé automatique est lancé pour l'ensemble du dossier. Si vous ne préférez pas ce comportement, vous pouvez ouvrir l'interface graphique et annuler la tâche.
## Télécharger des fichiers
Les commandes suivantes vous permettent de télécharger des fichiers depuis le compartiment S3 correspondant que vous avez configuré dans votre fichier de configuration. Vous pouvez exécuter ces commandes depuis n'importe quel emplacement de votre ordinateur. Nous vous recommandons d'exécuter ces commandes depuis root.
File TransferImpossible de télécharger directement depuis les classes de stockage Deep Archive ou Glacier. Cela est dû au fait qu'ils sont stockés dans un système différent. Ces types d'objets nécessitent une méthode différente pour récupérer les fichiers. Pour plus d'informations sur la récupération d'objets provenant de différents systèmes, voir [Restauration d'un objet archivé](https://docs.aws.amazon.com/AmazonS3/latest/userguide/restoring-objects.html). Pour plus d'informations sur les classes de stockage, consultez [Classes de stockage Amazon S3](https://aws.amazon.com/s3/storage-classes/).
**Note**
Nous vous recommandons de désactiver le mode veille sur votre ordinateur local. Si votre ordinateur active le mode veille, les transferts en cours peuvent être interrompus. Dans **Réglages**, activez l'option **Désactiver le mode veille (macOS uniquement).**
**Pour démarrer les téléchargements à l'aide de la CLI**
1. Ouvrez un terminal .
1. (Recommandé) Accédez au dossier dans lequel vous souhaitez télécharger vos fichiers.
1. Exécutez la commande suivante depuis n'importe où sur votre ordinateur pour télécharger des fichiers depuis Amazon S3 sur votre ordinateur.
```
filetransfer download [transfer profile]
[relative path]
```
1. Remplacez *[profil de transfert]* par le profil de transfert que vous souhaitez utiliser.
1. Remplacez *[chemin relatif]* par le chemin vers lequel vous souhaitez télécharger vos fichiers.
1. Un chemin relatif ne commence pas par une `/` (barre oblique). Exemple : `Users/username/Desktop/folder1`
1. N'utilisez pas de chemin absolu. Un chemin de fichier absolu commence par une `/` (barre oblique). Exemple : `/Users/username/Desktop/folder1`
1. Exemple de commande : `filetransfer download [transfer profile name] /Users/username/Desktop/folder1`
File Transfervérifie dans la File Transfer base de données locale si le fichier que vous avez sélectionné a déjà été téléchargé.
### Indicateurs
Des drapeaux peuvent être ajoutés à la fin d'une commande afin d'effectuer certaines actions. L'utilisation de drapeaux est facultative.
| Indicateur | Description | Exemple |
| --- | --- | --- |
| --help | Répertoriez les drapeaux et les commandes disponibles. | `filetransfer --help` |
| --checksum - algorithme | Définissez le calcul File Transfer de la somme de contrôle effectué. Valeurs prises en charge : `md5``XXHash`,`XXHash64`, et`XXH3`. | `filetransfer download [remote configuration] [relative path] –-checksum-algorithm xxhash64` |
| --enable-metadata-filter | Lorsqu'il est utilisé, File Transfer filtre automatiquement les fichiers de métadonnées du système. Ces fichiers incluent `Thumbs.db``.DS_Store`, et les fichiers commençant par `._.` | `filetransfer download [remote configuration] [relative path] --enable-metadata-filter` |
| --filtre | Filtrez les fichiers transférés en fonction de leur format. Le champ de filtre accepte les expressions régulières valides. Exemple : transfère `^.*\.(mov)$` uniquement les fichiers se terminant par`.mov`. Des filtres peuvent être ajoutés au fichier de configuration pour effectuer certaines actions. Lorsque vous ajoutez des filtres à la configuration au lieu de les utiliser comme indicateurs sur des commandes spécifiques, File Transfer applique l'action à tous les transferts. | `filetransfer download [remote configuration] [relative path] --filter "^.*\.(mov)$"` Cette commande télécharge uniquement les fichiers `.mov` formatés. |
| --force | Forcez un transfert indépendamment des filtres ou des conflits. Par défaut, les fichiers précédemment transférés File Transfer ne seront pas transférés. Le drapeau de force fait File Transfer ignorer les filtres ou les conflits. Cette fonction est utile si vous avez accidentellement supprimé un fichier à télécharger. | `filetransfer download [remote configuration] [relative path] --force` |
| --âge maximal | Transférez uniquement les fichiers créés ou modifiés au cours d'une période se terminant à l'heure actuelle. Si aucune unité n'est fournie, l'âge maximum sera exprimé en secondes. Par exemple, `2d` téléchargera les fichiers des deux derniers jours et `3500` téléchargera les fichiers des 3500 dernières secondes. | `filetransfer download [remote configuration] [relative path] --max-age “2d”` La commande ci-dessus téléchargera uniquement les fichiers des 2 derniers jours dans le compartiment S3. |
| --nombre de réessais | En cas d'erreur, File Transfer tentera de transférer vos fichiers autant de fois que le nombre de nouvelles tentatives sera atteint. | `filetransfer download [remote configuration] [relative path] --retry-count 4` |
| --taille du morceau | Taille du morceau en Mo (25 par défaut) | `filetransfer download [remote configuration] [relative path] --chunk-size 50` |
| --réglage automatique | Permettre à l'outil de déterminer les meilleures valeurs de configuration pour optimiser le transfert | `filetransfer download [remote configuration] [relative path] --auto-tuning true` |
| --max-active-checksums | Nombre maximum de checksums actifs (1 par défaut) | `filetransfer download [remote configuration] [relative path] --max-active-checksums 5` |
| --max-active-transfers | Nombre maximum de transferts | `filetransfer download [remote configuration] [relative path] --max-active-transfers 10` |
| --préfixe | Chemin du préfixe S3 pour les chargements et les téléchargements | `filetransfer download [remote configuration] [relative path] --prefix my/s3/path` |
| --profile | AWS profil nommé | `filetransfer download [remote configuration] [relative path] --profile my_named_profile` |
| --fils | Nombre de fils par téléchargement (10 par défaut) | `filetransfer download [remote configuration] [relative path] --threads 10` |
| FILETRANSFER\$1CONFIG\$1DIR | Remplace le `.filetransfer` dossier par défaut. Cette variable peut définir n'importe quel répertoire pour stocker le fichier de configuration et le fichier de base de données. Si `FILETRANSFER_CONFIG_DIR` ce n'est pas le cas`~/.filetransfer`, la valeur par défaut est utilisée. Les fichiers doivent toujours être nommés `configuration.yaml` ou`configuration.yaml`, et`checksum-cache.db`. S'ils n'existent pas, ils sont créés. | `FILETRANSFER_CONFIG_DIR=Desktop/config1 filetransfer download [remote configuration] [relative path]` |