MinIO List

MinIO List

Certified

List objects on a MinIO bucket

Lists objects in a MinIO bucket, optionally filtered by prefix, delimiter, or regular expression.

yaml
type: io.kestra.plugin.minio.List
yaml
id: minio_list
namespace: company.team

tasks:
  - id: list_objects
    type: io.kestra.plugin.minio.List
    accessKeyId: "<access-key>"
    secretKeyId: "{{ secret('MINIO_SECRET_KEY_ID') }}"
    region: "eu-central-1"
    bucket: "my-bucket"
    prefix: "sub-dir"

List files from an S3-compatible storage — here, Spaces Object Storage from Digital Ocean.

yaml
id: s3_compatible_list
namespace: company.team

tasks:
  - id: list_objects
    type: io.kestra.plugin.minio.List
    accessKeyId: "<access-key>"
    secretKeyId: "{{ secret('MINIO_SECRET_KEY_ID') }}"
    endpoint: https://<region>.digitaloceanspaces.com
    bucket: "kestra-test-bucket"
Properties

Access Key Id for authentication

The bucket name

CA PEM certificate content

CA certificate as text, used to verify SSL/TLS connections to custom MinIO endpoints.

Client PEM certificate content

PEM client certificate as text, used to authenticate the connection to MinIO (mTLS).

A delimiter is a character you use to group keys

URL to the MinIO endpoint

DefaultBOTH
Possible Values
FILESDIRECTORYBOTH

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

Defaulttrue

Indicates whether task should include versions in output

Marker is where you want to start listing from

Start listing after this specified key. Marker can be any key in the bucket.

Default1000

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.

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

Limits the response to keys that begin with the specified prefix

Defaulttrue

Indicates whether it should look into subfolders

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

MinIO region with which the SDK should communicate

Secret Key Id for authentication

SSL/TLS configuration options

Definitions
insecureTrustAllCertificatesbooleanstring

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.

Limits the response to keys that ends with the specified string

The list of objects

Definitions
etagstring
keystring
lastModifiedstring
Formatdate-time
owner
displayNamestring
idstring
sizeinteger
uristring
Formaturi
Unitcount

Number of objects returned from the MinIO bucket list.