# Gestion des transferts

La commande de gestion des transferts est `transfer`. Cette commande doit ensuite être suivie d’une action. La documentation complète 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

- `-a`: 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

    waarp-gateway -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

    waarp-gateway -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

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

## Consulter les transferts

Pour lister les transferts, 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

    waarp-gateway -a 'https://admin@127.0.0.1:8080' transfers 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

    waarp-gateway '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.

Exemple

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

## Annuler un transfert

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

Exemple

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

## Reprogrammer un transfert

Pour reprogrammer un transfert, la commande est `transfer 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

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