File system List

File system List

Certified

List local files

Lists files under a directory allowed by allowed-paths; optional regexp filter and recursion. Sorted with sort (default NONE) before limiting results to maxFiles (default 25). Local access requires allowed-paths in plugin defaults.

Example (Kestra config): 

plugins: 
  configurations: 
    - type: io.kestra.plugin.fs.local.List
      values: 
        allowed-paths: 
          - /data/files
yaml
type: io.kestra.plugin.fs.local.List
yaml
id: fs_local_list
namespace: company.team

tasks:
  - id: list_files
    type: io.kestra.plugin.fs.local.List
    from: "/data/input"
    regExp: ".*.csv"
    recursive: true
    sort: LAST_MODIFIED_DESC
Properties

Directory to scan

Default25

Maximum files to retrieve

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

Defaultfalse

Include subdirectories

If true, list files recursively.

Regular expression filter

Only files matching this regex are listed.

DefaultNONE
Possible Values
NONELAST_MODIFIED_ASCLAST_MODIFIED_DESCNAME_ASCNAME_DESC

Sort order applied to the list before maxFiles truncation

NONE (default) preserves the order returned by the filesystem walk. LAST_MODIFIED_ASC/LAST_MODIFIED_DESC sort by last modified date, oldest/newest first. NAME_ASC/NAME_DESC sort alphabetically by file name.

Count of files found

List of files found

Definitions
accessedDatestring
Formatdate-time
createdDatestring
Formatdate-time
isDirectoryboolean
localPath
modifiedDatestring
Formatdate-time
namestring
parentstring
sizeinteger
uristring
Formaturi

More Plugins in this Category

VMware (EE)
VMware
Enterprise

Tasks that automate VMware vSphere operations within Kestra workflows.

Infrastructure

33 tasks

3 blueprints

Canonical (EE)
Canonical
Enterprise

Tasks to interact with Canonical services, enabling automation and infrastructure management through API-driven workflows.

CloudInfrastructure

5 tasks