Action AWS S3
S3 Download File
Downloads a file from an AWS S3 bucket to a local path. Compatible with S3-compatible services via the Endpoint URL parameter.
Node IDS3DownloadFileAction
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
Bucket bucket | string | Yes | — | The S3 bucket name to download from. |
Object Key key | string | Yes | — | The key (path) of the object to download, e.g. "assets/textures/diffuse.png". |
Local File Path local_file_path | string | Yes | — | Absolute local path to save the downloaded file to. Must not contain ".." path traversal. |
AWS Region region | string | Yes | us-east-1 | AWS region where the bucket lives. |
Access Key ID Secret access_key_id_secret | string | Yes | AWS_ACCESS_KEY_ID | Key in the Secrets store holding your AWS Access Key ID. |
Secret Access Key Secret secret_access_key_secret | string | Yes | AWS_SECRET_ACCESS_KEY | Key in the Secrets store holding your AWS Secret Access Key. |
Endpoint URL (Advanced) endpoint_url | string | No | — | Override the S3 endpoint URL for S3-compatible services and testing. |
Allow Private Networks allowPrivateNetworks | boolean | No | false | If false (default), the Endpoint URL override is validated against SSRF protection rules. Enable only when using a private S3-compatible endpoint (e.g. MinIO on an internal network). |
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
Execute input0 | object | Yes | Execution signal. |
Outputs
| Output | Type | Identifier | Description |
|---|---|---|---|
On Success output0 | object | result | Fires on successful download. Contains bucket, key, local_file_path, and region. |
On Error output1 | object | error | Fires on failure with error message. |