Download
type: "io.kestra.plugin.fs.http.Download"
Download file from http server
This task connects to http server and copy file to kestra file storage
# Examples
id: "download"
type: "io.kestra.plugin.fs.http.Download"
headers:
user-agent: "kestra-io"
uri: "https://server.com/file"
# Properties
# body
- Type: string
- Dynamic: ✔️
- Required: ❌
The full body as string
# contentType
- Type: string
- Dynamic: ✔️
- Required: ❌
The request content type
# formData
- Type: object
- Dynamic: ✔️
- Required: ❌
The form data to be send
# headers
- Type: object
- SubType: string
- Dynamic: ✔️
- Required: ❌
The header to pass to current request
# method
Type: string
Dynamic: ❌
Required: ❌
Default:
GET
Possible Values:
OPTIONS
GET
HEAD
POST
PUT
DELETE
TRACE
CONNECT
PATCH
CUSTOM
The http method to use
# options
- Type: RequestOptions
- Dynamic: ❓
- Required: ❌
The http request options
# sslOptions
- Type: SslOptions
- Dynamic: ❓
- Required: ❌
The ssl request options
# uri
- Type: string
- Dynamic: ✔️
- Required: ❌
The fully-qualified URIs that point to destination http server
# Outputs
# code
- Type: integer
The status code of the response
# headers
- Type: object
- SubType: array
The headers of the response
# uri
- Type: string
The url of the downloaded file on kestra storage
# Definitions
# RequestOptions
# basicAuthPassword
- Type: string
- Dynamic: ✔️
- Required: ❌
The basicAuth password.
# basicAuthUser
- Type: string
- Dynamic: ✔️
- Required: ❌
The basicAuth username.
# connectTimeout
- Type: string
- Dynamic: ❌
- Required: ❌
- Format:
duration
The connect timeout.
# connectionPoolIdleTimeout
- Type: string
- Dynamic: ❌
- Required: ❌
- Default:
0.0
- Format:
duration
The idle timeout for connection in the client connection pool.
# defaultCharset
- Type: Charset
- Dynamic: ❌
- Required: ❌
- Default:
UTF-8
Sets the default charset to use.
# followRedirects
- Type: boolean
- Dynamic: ❌
- Required: ❌
- Default:
true
Whether redirects should be followed.
# logLevel
Type: string
Dynamic: ❌
Required: ❌
Possible Values:
ALL
TRACE
DEBUG
INFO
WARN
ERROR
OFF
NOT_SPECIFIED
The level to enable trace logging at.
# maxContentLength
- Type: integer
- Dynamic: ❌
- Required: ❌
- Default:
10485760
Sets the maximum content length the client can consume.
# proxyAddress
- Type: string
- Dynamic: ✔️
- Required: ❌
The proxy to use.
# proxyPassword
- Type: string
- Dynamic: ✔️
- Required: ❌
The proxy password to use.
# proxyPort
- Type: integer
- Dynamic: ❌
- Required: ❌
The proxy port to use.
# proxyType
Type: string
Dynamic: ❌
Required: ❌
Default:
DIRECT
Possible Values:
DIRECT
HTTP
SOCKS
The proxy type to use.
# proxyUsername
- Type: string
- Dynamic: ✔️
- Required: ❌
The proxy user to use.
# readIdleTimeout
- Type: string
- Dynamic: ❌
- Required: ❌
- Default:
300.000000000
- Format:
duration
The default amount of time to allow read operation connections to remain idle.
# readTimeout
- Type: string
- Dynamic: ❌
- Required: ❌
- Default:
10.000000000
- Format:
duration
The default read timeout.
# SslOptions
# insecureTrustAllCertificates
- Type: boolean
- Dynamic: ❌
- Required: ❌
Whether the client should disable checking of the remote SSL certificate.
Only applies if no trust store is configured. Note: This makes the SSL connection insecure, and should only be used for testing. If you are using a self-signed certificate, set up a trust store instead.