Settings
| Setting | What it is |
|---|---|
| Name prefix | Byte-exact and case-sensitive. Lists the environment this run is in, 1,000 files per page. |
| Include archived files | Archived files are listed but cannot be read — leave this off before a loop. |
| If more files | Return the first page with a nextCursor to list a folder of any size in a loop. |
| Cursor | Continue a previous list from its nextCursor. |
Technical details
| Key | Value |
|---|---|
prefix | textthe start of file names |
includeArchived | true/false, by default false |
ifMoreFiles | "fail" or "first", by default "fail" |
cursor | text |
Output
| Field | Type |
|---|---|
files | array |
countNumber of files | number |
nextCursorCursor for the next page | string |
Sample output, and the expression for each field
- count0
- files[]
Errors
When a step of this node stops a run, the run page shows a code. Look it up:
Example step
The step as a flow file holds it. Replace each value in <…>.
{
"config": {
"cursor": "",
"ifMoreFiles": "fail",
"includeArchived": false,
"prefix": ""
},
"label": "List",
"type": "file.list",
"version": 1
}