N8N Tools - S3 Enhanced icon

N8N Tools - S3 Enhanced

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

Overview

The node provides enhanced integration with S3-compatible storage services, supporting a wide range of bucket and object operations including multipart uploads. Specifically, the Complete Multipart Upload operation finalizes a multipart upload by assembling previously uploaded parts into a single object in the specified bucket.

This operation is useful when uploading large files in multiple parts to improve reliability and performance. After all parts are uploaded individually, this node call completes the process by instructing the storage service to combine them.

Practical example:
You have a large video file split into chunks uploaded separately using multipart upload. Once all chunks are uploaded, you use this node's Complete Multipart Upload operation to finalize and make the full video available in your bucket.

Properties

Name Meaning
Bucket Name The name of the target S3 bucket where the multipart upload is being completed.
Upload ID The unique identifier for the multipart upload session that was initiated earlier.
Parts A JSON array listing each part's ETag and PartNumber, representing the uploaded parts to be combined. Example: [{"ETag":"etag1","PartNumber":1},{"ETag":"etag2","PartNumber":2}]

Output

The output JSON contains details about the completed multipart upload:

  • bucket: The bucket name where the object resides.
  • key: The object key (path) in the bucket.
  • uploadId: The multipart upload ID used to complete the upload.
  • etag: The ETag of the newly created object after completion.
  • location: The URL location of the completed object.
  • message: Confirmation message indicating successful completion.
  • operation: The operation performed (completeMultipartUpload).
  • timestamp: ISO timestamp of when the operation was executed.
  • success: Boolean flag indicating success (true).

No binary data is output by this operation.

Dependencies

  • Requires an S3-compatible storage service accessible via credentials (access key, secret key, optional session token, region, endpoint).
  • The node depends on AWS SDK v3 clients for S3 operations.
  • Proper permissions must be granted to perform multipart upload completion on the target bucket.
  • Credentials must be configured in n8n with appropriate access rights.

Troubleshooting

  • Invalid parts JSON format: If the Parts input is not valid JSON or does not contain the required fields (ETag and PartNumber), the node will throw an error. Ensure the parts array is correctly formatted.
  • Upload ID not found or expired: Using an incorrect or expired upload ID will cause failure. Verify the upload ID corresponds to an active multipart upload.
  • Permission denied: Insufficient permissions to complete multipart uploads on the bucket will result in access errors. Check IAM policies or equivalent permission settings.
  • Network or endpoint issues: Connection problems to the S3 endpoint can cause failures. Confirm network connectivity and correct endpoint configuration.
  • General S3 errors: Other AWS S3 errors may occur; review error messages for clues and verify bucket existence and state.

Links and References

Discussion