# Gestion des transferts

La commande de gestion des transferts en cours est `transfer`. Cette commande doit ensuite être suivie d’une action. La documentation complète de la commande est disponible ici.

Pour les transferts terminés, la commande est `history`. La documentation de la commande est disponible ici.

## Ajouter un transfert

Pour programmer un nouveau transfert, la commande est `transfer add`. Les options de commande suivantes doivent être fournies:

- `-f`: le nom du fichier à transférer

- `-n`: le nouveau nom du fichier après le transfert (optionnel, par défaut le nom reste identique à l’original)

- `-w`: le sens du transfert (`pull` ou `push`)

- `-p`: le partenaire de transfert

- `-l`: le compte distant utilisé pour le transfert

- `-r`: la règle utilisée pour le transfert

- `-d`: la date du transfert en format ISO 8601 (optionnel, par défaut le transfert démarre immédiatement)

Exemple de commande pour effectuer un transfert

    waarp-transfer -a 'https://admin@127.0.0.1:8080' transfer add -f 'exemple.txt' -w 'push' -p 'opensshd' -a 'toto' -r 'règle rebond'

Si les paramètres du transfert sont valides, le transfert sera programmé et l’identifiant attribué au transfert sera affiché dans la console.

## Interrompre/Reprendre un transfert

Un transfert peut être interrompu avec la commande `transfer pause`, suivie de l’identifiant du transfert.

Exemple de commande pour mettre en pause un transfert

    waarp-transfer -a 'https://admin@127.0.0.1:8080' transfer pause '1234'

Pour reprendre un transfert interrompu, la commande est `transfer resume`, suivi de l’identifiant du transfert.

Exemple de commande pour reprendre un transfert en pause

    waarp-transfer -a 'https://admin@127.0.0.1:8080' transfer resume '1234'

## Consulter les transferts

Pour lister les transferts en cours, la commande est `transfer list`. Les options de commande permettent de filtrer les résultats selon divers critères, pour plus de détails, voir la reference.

Exemple de commande pour lister les transferts actifs

    waarp-transfer -a 'https://admin@127.0.0.1:8080' transfers list

Pour les transferts terminés, la commande est `history list`. La documentation de la commande est disponible ici.

Exemple

Exemple de commande pour lister les transferts terminés

    waarp-transfer -a 'https://admin@127.0.0.1:8080' history list

## Mettre un transfert en pause

Pour mettre un transfert en pause, la commande est transfer pause, suivie ensuite de l’identifiant du transfert.

Exemple

Exemple de commande pour mettre en pause le transfer 1234

    waarp-transfer 'https://admin@127.0.0.1:8080' transfer pause '1234'

## Reprendre un transfert arrêté

Pour reprendre un transfert à l’arrêt, la commande est transfer resume, suivie ensuite de l’identifiant du transfert. Le transfert reprendra là où il s’était arrêté.

Note

Seuls les transferts en pause ou en erreur peuvent être repris.

## Annuler un transfert

Pour annuler un transfert, la commande est `transfer cancel`, suivie ensuite de l’identifiant du transfert.

Exemple de commande pour annuler un transfert

    waarp-transfer -a 'https://admin@127.0.0.1:8080' transfer cancel '1234'

## Reprogrammer un transfert

Pour reprogrammer un transfert, la commande est `history retry`, suivie ensuite de l’identifiant du transfert. Le transfert recommencera depuis le début.

Note

Seuls les transferts terminés peuvent être reprogrammés.

Exemple de commande pour reprogrammer un transfert

    waarp-transfer -a 'https://admin@127.0.0.1:8080' transfer retry '1234'