N8N Tools - S3 EnhancedInstall

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 and POSTs for secure temporary access, multipart uploads for large files, bucket and object management, ACL and tagging configurations, lifecycle policies, versioning, logging, notifications, replication, encryption, website hosting, metrics, analytics, inventory, request payment settings, accelerate configuration, and querying object content using SQL expressions.

This node is beneficial in scenarios where users need fine-grained control over S3 buckets and objects beyond simple upload/download, including managing bucket policies, multipart uploads, or generating temporary access URLs without exposing credentials.

Practical examples:

• Generating a presigned URL to allow a client to download a file securely without sharing AWS credentials.
• Initiating a multipart upload for uploading large files in parts.
• Listing all parts of an ongoing multipart upload to monitor progress.
• Setting bucket lifecycle rules to automatically archive or delete old objects.
• Copying objects between buckets within the same or different regions.
• Querying CSV data stored in an object using SQL expressions to extract specific rows.

Properties

For the List Parts operation specifically, the node requires:

• Bucket Name: The target bucket containing the multipart upload.
• Upload ID: The identifier of the multipart upload whose parts are to be listed.

Output

The output JSON structure for the List Parts operation includes:

• bucket: The name of the bucket.
• key: The object key (path) associated with the multipart upload.
• uploadId: The multipart upload ID.
• parts: An array of parts uploaded so far, each typically containing metadata like part number, ETag, size, and last modified date.
• maxParts: The maximum number of parts returned in this response.
• isTruncated: A boolean indicating if there are more parts available beyond those returned.

This output allows users to inspect the status and details of each uploaded part in a multipart upload session.

Dependencies

• Requires an S3-compatible service endpoint with valid credentials (access key ID, secret access key, optional session token).
• Uses AWS SDK clients internally to communicate with the S3 API.
• Requires proper n8n credential setup for the S3-compatible service.
• No additional environment variables are explicitly required beyond the configured credentials.

Troubleshooting

• Invalid Credentials Errors:
  Common error messages include invalid access key ID or secret access key. Verify that the provided credentials are correct and have sufficient permissions.

• Connection Issues:
  Errors like "Cannot connect to endpoint" indicate network or endpoint misconfiguration. Check the endpoint URL and network connectivity.

• Invalid JSON Format:
  For properties expecting JSON input (not applicable directly to List Parts but relevant for other operations), ensure the JSON is well-formed.

• Multipart Upload Not Found:
  If the specified upload ID does not exist or has been completed/aborted, the node may return errors or empty results. Confirm the upload ID is current and valid.

• Permission Denied:
  Access denied errors suggest insufficient permissions on the bucket or multipart upload. Ensure the credentials have appropriate rights.

Links and References

• AWS S3 Multipart Upload Documentation
• AWS SDK for JavaScript v3 - S3 Client
• Presigned URLs in Amazon S3
• n8n Documentation - Creating Custom Nodes