File system Uploads

File system Uploads
Certified
Upload multiple files to FTPS

Uploads each provided file over FTPS to the target directory. Defaults: port 990, EXPLICIT mode, PROT P data channel, passive mode on, remote IP verification on, paths relative to user home. insecureTrustAllCertificates skips SSL checks for testing.

yaml
type: io.kestra.plugin.fs.ftps.Uploads

Examples

yaml
id: fs_ftps_uploads
namespace: company.team

inputs:
  - id: file1
    type: FILE
  - id: file2
    type: FILE

tasks:
  - id: uploads
    type: io.kestra.plugin.fs.ftps.Uploads
    host: localhost
    port: 990
    username: foo
    password: "{{ secret('FTPS_PASSWORD') }}"
    from:
      - "{{ inputs.file1 }}"
      - "{{ inputs.file2 }}"
    to: "/upload/dir2"

Properties

from *stringobject

Files to upload (kestra:// URIs)

Kestra internal storage URIs; accepts a single URI string, a list of URIs, a map of destination filenames to URIs (to preserve original filenames), or a URI pointing to a file that contains URIs.

Pebble expression referencing an Internal Storage URI e.g. {{ outputs.mytask.uri }}.

Definitions

io.kestra.plugin.fs.vfs.List

enableSshRsa1*booleanstring

Enable the RSA/SHA1 algorithm (disabled by default)

from*string

Directory URI to list

host*string

Remote host

maxFilesintegerstring

Maximum files to retrieve

passwordstring

Password

pluginDefaultsRefstring

Reference (ref) of the pluginDefaults to apply to this task.

recursivebooleanstring

List files recursively

regExpstring

Regexp filter on full path

sortstring

Possible Values

NONELAST_MODIFIED_ASCLAST_MODIFIED_DESCNAME_ASCNAME_DESC

Sort order applied to the list before maxFiles truncation

NONE (default) preserves the order in which the server returns files. LAST_MODIFIED_ASC/LAST_MODIFIED_DESC sort by last modified date, oldest/newest first. NAME_ASC/NAME_DESC sort alphabetically by file name.

typeobject

usernamestring

Username

host *string

Remote host

to *string

Destination directory

dataChannelProtectionLevel string

DefaultP

Possible Values

CSEP

Data channel protection level

PROT command value (P, C, etc.). Default P (encrypted).

enableSshRsa1 booleanstring

Defaultfalse

Enable the RSA/SHA1 algorithm (disabled by default)

insecureTrustAllCertificates booleanstring

Trust all certificates

Skip server certificate validation. Insecure: this disables protection against man-in-the-middle attacks and must not be enabled in production. Use only for testing against self-signed or untrusted certificates.

maxFiles integerstring

Default25

Maximum files to upload

mode string

DefaultEXPLICIT

Possible Values

IMPLICITEXPLICIT

Select FTPS mode

Choose implicit or explicit FTPS. Default EXPLICIT.

options

Default

{
  "connectionTimeout": "PT30S",
  "dataTimeout": "PT30S",
  "socketTimeout": "PT30S",
  "controlKeepAliveTimeout": "PT30S",
  "controlKeepAliveReplyTimeout": "PT30S"
}

FTP client options

Definitions

io.kestra.plugin.fs.ftp.FtpInterface-Options

connectionTimeoutstring

DefaultPT30S

Control connection timeout

Maximum time to open the control channel. Default 30s.

controlKeepAliveReplyTimeoutstring

DefaultPT30S

Keep-alive reply timeout

How long to wait for keep-alive responses before failing. Default 30s.

controlKeepAliveTimeoutstring

DefaultPT30S

Control keep-alive interval

Sends keep-alive commands during long transfers. Default 30s.

dataTimeoutstring

DefaultPT30S

Data channel timeout

Maximum time to open the data socket. Default 30s.

socketTimeoutstring

DefaultPT30S

Socket read timeout

Timeout for socket reads and writes once connected. Default 30s.

overwrite booleanstring

Defaulttrue

Overwrite existing files

If false, fails when the destination already exists.

passiveMode booleanstring

Defaulttrue

Use passive data connections

Passive mode avoids most firewall and NAT issues and is enabled by default (true). Set to false to force active mode.

password string

Password

pluginDefaultsRef string

Reference (ref) of the pluginDefaults to apply to this task.

port string

Default990

Remote port

proxyHost string

FTP proxy hostname

proxyPort string

FTP proxy port

proxyType string

Possible Values

DIRECTHTTPSOCKS

FTP proxy type

regExp string

Regexp filter on full path

Only source URIs fully matching this regex are uploaded. Example: .*\.sql$.

remoteIpVerification booleanstring

Defaulttrue

Verify data channel IP

Ensures the responding server IP matches the control connection to prevent spoofed data channels.

rootDir booleanstring

Defaulttrue

Treat path as user home root

If true (default), remote paths are resolved relative to the authenticated user's home directory.

username string

Username

Outputs

files array

SubTypestring

The fully-qualified URIs that point to the uploaded files on remote

NetBox

Enterprise

Enterprise NetBox tasks to create, update, and query devices, IP addresses, and sites over the NetBox API.

Infrastructure

Clickhouse

Tasks that connect to ClickHouse via JDBC to run queries and loads.

Data

File system UploadsCertifiedUpload multiple files to FTPS

File system Uploads

More Plugins in this Category

NetBox

Clickhouse

File system Uploads
Certified
Upload multiple files to FTPS