Upload

Upload a file to a MinIO bucket.

yaml
type: "io.kestra.plugin.minio.Upload"

Examples

yaml
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.

yaml
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.

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

SubType string

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.

Outputs

bucket string

key string

versionId string

The version of the object.

Definitions

List objects on a MinIO bucket.

accessKeyId string

Access Key Id for authentication.

bucket string

The bucket name.

delimiter string

A delimiter is a character you use to group keys.

endpoint string

URL to the MinIO endpoint.

filter string

Default BOTH

Possible Values

FILESDIRECTORYBOTH

The type of objects to filter: files, directory, or both.

includeVersions booleanstring

Default true

Indicates 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

Default 1000

Sets 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

Default true

Indicates 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.

startAfter string

Limits the response to keys that ends with the specified string.

type object

​Upload

Upload