AWS S3

Node catalog Actions

On this page

Buckets, files and folders on Amazon S3

Usage and specifics

Folders are object prefixes, not ordinary directories. Set bucket and key for the operation. delete_folder removes objects under the prefix; a presigned URL grants temporary access.

Technical type : aws_s3. Runtime : nodulz.

Credentials and prerequisites

Create and configure the credential : aws

Create credentials in your nodulz instance’s Credentials area, then select them on the node. Availability depends on ownership and sharing. See the credentials guide for access and rotation.

Parameters

Names below are technical keys. Defaults are not a ready-to-run configuration: complete fields required by your operation. Paths containing [] describe list items; some fields depend on the selected mode.

Parameter	Type	Default	Values / limits
`credentialId`	`string`	-	-
`serviceInstanceId`	`string`	-	-
`connectionSource`	`enum`	`"credential"`	`credential`, `service`
`operation`	`enum`	`"upload_file"`	`create_bucket`, `delete_bucket`, `list_buckets`, `search_bucket`, `copy_file`, `delete_file`, `download_file`, `presign_url`, `list_files`, `upload_file`, `create_folder`, `delete_folder`, `list_folders`
`bucket`	`string`	`""`	-
`key`	`string`	`""`	-
`sourceKey`	`string`	`""`	-
`destKey`	`string`	`""`	-
`prefix`	`string`	`""`	-
`content`	`string`	`""`	-
`encoding`	`enum`	`"base64"`	`utf8`, `base64`
`contentType`	`string`	`""`	-
`metadata`	`string`	`""`	-
`maxKeys`	`number`	`100`	-; ≥ 1, ≤ 1000
`searchName`	`string`	`""`	-

Configuration help

credentialId Storage credential: Access keys and endpoint are stored on the Credentials page.
searchName Search name: Exact bucket name or substring to match when searching.
bucket Bucket: Bucket name (lowercase). Supports workflow expressions.
key Object key: Path to the object inside the bucket (e.g. folder/file.txt).
sourceKey Source key: Key of the object to copy.
destKey Destination key: Target key for the copy.
prefix Prefix: Key prefix for listing or deleting a folder tree.
encoding Encoding: How content is interpreted before upload.
content Content: File body (UTF-8 or base64 depending on encoding).
contentType Content type: Optional MIME type (e.g. application/pdf).
metadata Metadata (JSON): Optional user metadata object (string values only).
maxKeys Max keys: Maximum objects returned per list request (1–1000).

Initial configuration

Initial catalog configuration example, to adapt before running. Keep secrets in credentials.

json

{
  "connectionSource": "credential",
  "operation": "upload_file",
  "bucket": "",
  "key": "",
  "sourceKey": "",
  "destKey": "",
  "prefix": "",
  "content": "",
  "encoding": "base64",
  "contentType": "",
  "metadata": "",
  "maxKeys": 100,
  "searchName": ""
}

Verification

Test with representative data. Check node output in the inspector and logs, then use editor mapping for downstream fields. A trigger test with a simulated payload does not validate external service delivery.