Get File
netscaler.get_file
ActionBusiness appsconnection required
Calls the NetScaler ADC API with the connection's credentials.
Read one file from the appliance, including its Base64 content.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- Custom
- Providers
- NetScaler ADC
- Secret shape
- {"username": "…", "password": "…"} — or {"sessionid": "…"}
- Config it needs
- base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
2 fields, 2 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
filename The file's name on its own; NetScaler refuses a name that carries a path. | string | Yes | — | — | wildcard-acme-2026.crt |
filelocation The directory on the appliance the file lives in, such as /nsconfig/ssl. | string | Yes | — | — | /nsconfig/ssl |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"filelocation": "/nsconfig/ssl",
"filename": "wildcard-acme-2026.crt"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
files One entry per file NITRO returned for the query. | array | — |
files[].filename The file's name, without its directory. | string | — |
files[].filelocation The directory the file was read from. | string | — |
files[].filecontent The file's bytes, Base64-encoded by NetScaler. | string | — |
files[].fileencoding How filecontent is encoded; NetScaler sends BASE64. | string | — |
files[].filemode The file mode; DIRECTORY when the entry is a folder. | string | — |
files[].filemodifiedtime When the file was last modified. | string | — |
files[].fileaccesstime When the file was last accessed. | string | — |
count How many entries the response carried. | number | — |
{
"count": 0,
"files": [
{
"fileaccesstime": "",
"filecontent": "",
"fileencoding": "",
"filelocation": "",
"filemode": "",
"filemodifiedtime": "",
"filename": ""
}
]
}Notes
- Both the name and the directory are required: NITRO reads a file by filename plus filelocation, never by path alone.
See Get File run in a workflow.
In a technical demo we add the NetScaler ADC connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.