Action AWS S3
S3 List Objects
Lists objects in an AWS S3 bucket, optionally filtered by a prefix. Returns an array of object keys. Compatible with S3-compatible services via the Endpoint URL parameter.
Node IDS3ListObjectsAction
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
Bucket bucket | string | Yes | — | The S3 bucket name to list objects from. |
Prefix Filter prefix | string | No | "" | Optional prefix to filter results, e.g. "assets/textures/". Leave empty to list all objects. |
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 listing. Contains keys array, count, bucket, and prefix. |
On Error output1 | object | error | Fires on failure with error message. |