Upload
Upload a file to a MinIO bucket.
type: "io.kestra.plugin.minio.Upload"Examples
id: minio_upload
namespace: company.team
inputs:
id: file
type: FILE
tasks:
- id: upload_to_storage
type: io.kestra.plugin.minio.Upload
accessKeyId: "<access-key>"
secretKeyId: "<secret-key>"
region: "eu-central-1"
from: "{{ inputs.file }}"
bucket: "my-bucket"
key: "path/to/file"
Upload file to an S3-compatible storage — here, Spaces Object Storage from Digital Ocean.
id: s3_compatible_upload
namespace: company.team
tasks:
- id: http_download
type: io.kestra.plugin.core.http.Download
uri: https://huggingface.co/datasets/kestra/datasets/raw/main/csv/orders.csv
- id: upload_to_storage
type: io.kestra.plugin.minio.Upload
accessKeyId: "<access-key>"
secretKeyId: "<secret-key>"
endpoint: https://<region>.digitaloceanspaces.com #example regions: nyc3, tor1
bucket: "kestra-test-bucket"
from: "{{ outputs.http_download.uri }}"
key: "data/orders.csv"
Properties
accessKeyId string
Access Key Id for authentication.
bucket string
The bucket name.
caPem string
CA PEM certificate content
CA certificate as text, used to verify SSL/TLS connections to custom MinIO endpoints.
clientPem string
Client PEM certificate content
PEM client certificate as text, used to authenticate the connection to MinIO (mTLS).
contentType string
A standard MIME type describing the format of the contents.
endpoint string
URL to the MinIO endpoint.
from Liststring
The file(s) to upload.
Can be a single file, a list of files or json array.
Pebble expression referencing an Internal Storage URI e.g. {{ outputs.mytask.uri }}.
key string
The key where to upload the file.
a full key (with filename) or the directory path if from is multiple files.
metadata object
A map of metadata to store with the object.
region string
MinIO region with which the SDK should communicate.
secretKeyId string
Secret Key Id for authentication.
ssl Non-dynamicSslOptions
SSL/TLS configuration options
Outputs
bucket string
key string
versionId string
The version of the object.
Definitions
io.kestra.core.http.client.configurations.SslOptions
insecureTrustAllCertificates booleanstring
Whether to 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.
List objects on a MinIO bucket.
accessKeyId string
Access Key Id for authentication.
bucket string
The bucket name.
caPem string
CA PEM certificate content
CA certificate as text, used to verify SSL/TLS connections to custom MinIO endpoints.
clientPem string
Client PEM certificate content
PEM client certificate as text, used to authenticate the connection to MinIO (mTLS).
delimiter string
A delimiter is a character you use to group keys.
endpoint string
URL to the MinIO endpoint.
filter string
BOTHFILESDIRECTORYBOTHThe type of objects to filter: files, directory, or both.
includeVersions booleanstring
trueIndicates whether task should include versions in output.
marker string
Marker is where you want to start listing from.
Start listing after this specified key. Marker can be any key in the bucket.
maxKeys integerstring
1000Sets the maximum number of keys returned in the response.
By default, the action returns up to 1,000 key names. The response might contain fewer keys but will never contain more.
prefix string
Limits the response to keys that begin with the specified prefix.
recursive booleanstring
trueIndicates whether it should look into subfolders.
regexp string
A regexp to filter on full key.
ex:
regExp: .* to match all files
regExp: .*2020-01-0.\\.csv to match files between 01 and 09 of january ending with .csv
region string
MinIO region with which the SDK should communicate.
secretKeyId string
Secret Key Id for authentication.
ssl SslOptions
SSL/TLS configuration options
startAfter string
Limits the response to keys that ends with the specified string.