N8N Tools - S3 Enhanced icon

N8N Tools - S3 Enhanced

Enhanced S3 operations with presigned URLs, multipart upload, and advanced features

Overview

The node "N8N Tools - S3 Enhanced" provides a comprehensive set of operations to interact with S3-compatible object storage services. It supports advanced features such as generating presigned URLs for secure temporary access, multipart uploads for large files, and detailed bucket management including lifecycle, policy, tagging, and more.

This node is beneficial in scenarios where you need to automate or integrate complex S3 bucket and object management tasks within workflows, such as:

  • Generating temporary download/upload URLs without exposing credentials.
  • Managing bucket lifecycle rules to automate object expiration or transition.
  • Handling multipart uploads for large files efficiently.
  • Configuring bucket policies, CORS, replication, encryption, and notifications programmatically.
  • Querying object content using SQL expressions.

Example use case: Automatically generate a presigned URL to allow a user to upload a file securely to a specific bucket without requiring direct access credentials.


Properties

Name Meaning
Bucket Name Name of the S3 bucket to operate on.

For the Get Bucket Lifecycle operation specifically, the only input property required is:

Name Meaning
Bucket Name Name of the S3 bucket

Output

For the Get Bucket Lifecycle operation, the output JSON structure includes:

  • bucket: The name of the bucket queried.
  • lifecycleRules: An array containing the lifecycle configuration rules of the bucket. Each rule typically defines actions like expiration, transitions, and filters applied to objects in the bucket.

Additionally, every output includes metadata fields:

  • operation: The operation performed (e.g., "getBucketLifecycle").
  • timestamp: ISO string timestamp when the operation was executed.
  • success: Boolean indicating if the operation succeeded.

If an error occurs, the output JSON will contain:

  • error: Error message describing the failure.
  • success: false
  • operation: The attempted operation.
  • timestamp: Timestamp of the failure.

No binary data is output by this operation.


Dependencies

  • Requires an S3-compatible service endpoint with valid credentials (access key ID and secret access key).
  • Uses AWS SDK v3 clients internally to communicate with the S3 API.
  • Requires n8n credentials configured with appropriate permissions to perform bucket lifecycle queries.
  • No additional environment variables are needed beyond standard credential setup.

Troubleshooting

Common Issues

  • Invalid Credentials: If the access key or secret key is incorrect, connection tests and operations will fail.
  • Insufficient Permissions: The user/role must have permission to call GetBucketLifecycleConfiguration on the specified bucket.
  • Malformed Lifecycle Rules: When setting lifecycle rules (not applicable here but related), invalid JSON format will cause errors.
  • Bucket Not Found: Specifying a non-existent bucket will result in an error from the S3 service.

Common Error Messages

  • "S3 operation failed: <message>": General failure during the S3 API call; check the message for details.
  • "Invalid lifecycle rules JSON format": Occurs when lifecycle rules JSON is malformed (for put operations).
  • "Access denied. Check your credentials and permissions.": Indicates insufficient IAM permissions.
  • "Cannot connect to endpoint. Check your endpoint URL and network connection.": Network or endpoint misconfiguration.

To resolve errors, verify credentials, bucket existence, permissions, and network connectivity.


Links and References

Discussion