Downloads

type: "io.kestra.plugin.fs.sftp.Downloads"

Download multiple files from SFTP server

Examples

Download a list of files and move it to an archive folders

id: fs_sftp_downloads
namespace: company.team

tasks:
  - id: downloads
    type: io.kestra.plugin.fs.sftp.Downloads
    host: localhost
    port: "22"
    username: foo
    password: pass
    from: "/in/"
    interval: PT10S
    action: MOVE
    moveDirectory: "/archive/"

Properties

from

• Type: string
• Dynamic: ✔️
• Required: ✔️

The directory to list

host

• Type: string
• Dynamic: ✔️
• Required: ✔️

Hostname of the remote server

action

• Type: string
• Dynamic: ✔️
• Required: ❌
• Possible Values:
  • MOVE
  • DELETE
  • NONE

The action to do on downloaded files

keyExchangeAlgorithm

• Type: string
• Dynamic: ❌
• Required: ❌

Configures Key exchange algorithm explicitly e. g diffie-hellman-group14-sha1, diffie-hellman-group-exchange-sha256, diffie-hellman-group-exchange-sha1, diffie-hellman-group1-sha1.

keyfile

• Type: string
• Dynamic: ✔️
• Required: ❌

Private keyfile in the PEM file format to connect to a remote server using SSH

To generate a PEM format key from OpenSSH, use the following command: ssh-keygen -m PEM

moveDirectory

• Type: string
• Dynamic: ✔️
• Required: ❌

**The destination directory in case off MOVE **

passphrase

• Type: string
• Dynamic: ✔️
• Required: ❌

Passphrase of the ssh key

password

• Type: string
• Dynamic: ✔️
• Required: ❌

Password on the remote server

port

• Type: string
• Dynamic: ✔️
• Required: ❌
• Default: 22

Port of the remote server

proxyHost

• Type: string
• Dynamic: ✔️
• Required: ❌

SFTP proxy host

proxyPassword

• Type: string
• Dynamic: ✔️
• Required: ❌

SFTP proxy password

proxyPort

• Type: string
• Dynamic: ✔️
• Required: ❌

SFTP proxy port

proxyType

• Type: string
• Dynamic: ✔️
• Required: ❌

SFTP proxy type

proxyUser

• Type: string
• Dynamic: ✔️
• Required: ❌

SFTP proxy user

recursive

• Type: boolean
• Dynamic: ❓
• Required: ❌
• Default: false

List file recursively

regExp

• Type: string
• Dynamic: ✔️
• Required: ❌

A regexp to filter on full path

rootDir

• Type: boolean
• Dynamic: ✔️
• Required: ❌
• Default: true

Is the path relative to the users home directory

username

• Type: string
• Dynamic: ✔️
• Required: ❌

Username on the remote server

Outputs

files

• Type: array
• SubType: File
• SubType: File
• Required: ❌

Metadata of downloaded files.

outputFiles

• Type: object
• SubType: string
• Required: ❌

The downloaded files as a map of from/to URIs.

Definitions

io.kestra.plugin.fs.vfs.models.File

Properties

accessDate

• Type: string
• Dynamic: ❓
• Required: ❓
• Format: date-time

fileType

• Type: string
• Dynamic: ❓
• Required: ❓
• Possible Values:
  • FOLDER
  • FILE
  • FILE_OR_FOLDER
  • IMAGINARY

flags

• Type: integer
• Dynamic: ❓
• Required: ❓

groupId

• Type: integer
• Dynamic: ❓
• Required: ❓

name

• Type: string
• Dynamic: ❓
• Required: ❓

path

• Type: string
• Dynamic: ❓
• Required: ❓
• Format: uri

permissions

• Type: integer
• Dynamic: ❓
• Required: ❓

size

• Type: integer
• Dynamic: ❓
• Required: ❓

symbolicLink

• Type: boolean
• Dynamic: ❓
• Required: ❓
• Default: false

updatedDate

• Type: string
• Dynamic: ❓
• Required: ❓
• Format: date-time

userId

• Type: integer
• Dynamic: ❓
• Required: ❓