MinIO Download
CertifiedDownload a file from a MinIO bucket
MinIO Download
Download a file from a MinIO bucket
Downloads a single object from a MinIO bucket to Kestra's internal storage.
type: io.kestra.plugin.minio.DownloadExamples
id: minio_download
namespace: company.team
tasks:
- id: download_from_storage
type: io.kestra.plugin.minio.Download
accessKeyId: "<access-key>"
secretKeyId: "{{ secret('MINIO_SECRET_KEY_ID') }}"
region: "eu-central-1"
bucket: "my-bucket"
key: "path/to/file"
Download file from an S3-compatible storage — here, Spaces Object Storage from Digital Ocean.
id: s3_compatible_download
namespace: company.team
tasks:
- id: download_from_storage
type: io.kestra.plugin.minio.Download
accessKeyId: "<access-key>"
secretKeyId: "{{ secret('MINIO_SECRET_KEY_ID') }}"
endpoint: https://<region>.digitaloceanspaces.com
bucket: "kestra-test-bucket"
key: "data/orders.csv"
Properties
accessKeyId string
Access Key Id for authentication
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150bucket 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).
endpoint string
URL to the MinIO endpoint
key string
The key of a file to download
region string
MinIO region with which the SDK should communicate
secretKeyId string
Secret Key Id for authentication
ssl
SSL/TLS configuration options
io.kestra.core.http.client.configurations.SslOptions
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.
versionId string
The specific version of the object
Outputs
contentLength integer
The size of the body in bytes
uri string
uriThe URI of the downloaded file on Kestra's internal storage
Metrics
file.size counter
bytesThe size in bytes of the downloaded file from the MinIO bucket.
