# Ajouter un transfert

Programme un nouveau transfert client avec les attributs ci-dessous.

Commande

    waarp-gateway transfer add

Options

-f <FILENAME>, --file=<FILENAME>

  Le chemin du fichier à transférer. Si le chemin est relatif, il sera relatif au dossier de la règle (ou du serveur en l’absence de dossier de règle).

-o <FILENAME>, --out=<FILENAME>

  Le chemin de destination du fichier transféré. Si le chemin est relatif, il sera relatif au dossier de la règle (ou du serveur en l’absence de dossier de règle).

-w <DIRECTION>, --way=<DIRECTION>

  La direction du transfert. Peut être `send` ou `receive`.

-c <CLIENT>, --client=<CLIENT>

  Le nom du client local avec lequel le transfert va être exécuté. Peut être omit si la gateway ne possède qu’un seul client du protocole concerné, auquel cas, le client en question sera sélectionné automatiquement.

-p <PARTNER>, --partner=<PARTNER>

  Le nom du partenaire distant avec lequel le transfert va être effectué.

-l <LOGIN>, --login=<LOGIN>

  Le nom du compte distant utilisé par Gateway pour d’identifier auprès du partenaire de transfert.

-r <RULE>, --rule=<RULE>

  Le nom de la règle utilisée pour le transfert.

-d <DATE>, --date=<DATE>

  La date de début du transfert en format ISO 8601. Par défaut, le transfert débutera immédiatement.

-n <FILENAME>, --name=<FILENAME>

  Obsolète depuis la version 0.5.0: Remplacé par –out.

  Le nom du fichier après le transfert. Par défaut, le nom d’origine est utilisé.

-i <KEY:VAL>, --info=<KEY:VAL>

  Une liste d’informations personnalisées à attacher au transfert. Les informations prennent la forme d’une liste de paires clé:valeur. Répéter l’option pour ajouter des paires supplémentaires.

--nb-of-attempts=<ATTEMPTS>

  Le nombre de fois que le transfert sera automatiquement retenté en cas d’échec.

--first-retry-delay=<DELAY>

  Le délai entre la tentative de transfert initiale et la première reprise automatique. Les unités de temps acceptées sont : `h` (heures), `m` (minutes) et `s` (secondes). Plusieurs unités peuvent être combinées ensemble (ex: `1h15m30s`).

--retry-increment-factor=<FACTOR>

  Le facteur par lequel le délai décris ci-dessus sera multiplié entre chaque nouvelle tentative. Par exemple, si le délai initial est de 30s et que le facteur est de 2, alors le délai sera doublé à chaque nouvelle tentative (30s, puis 1m, 2m, 4m, etc) jusqu’à ce que le transfert réussisse ou bien que le nombre de tentatives soit épuisé.

Exemple

    waarp-gateway transfer add -f 'path/to/file' -w 'send' -p 'waarp_sftp' -l 'toto' -r 'règle_1' -d '2022-01-01T01:00:00Z'