N8N Tools - S3 Enhanced icon

N8N Tools - S3 Enhanced

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

Actions66

Overview

This node provides enhanced integration with S3-compatible object storage services, enabling a wide range of bucket and object management operations. It supports advanced features such as generating presigned URLs for secure temporary access, multipart uploads for large files, and detailed bucket configurations including tagging, lifecycle policies, CORS, encryption, and more.

Typical use cases include:

  • Generating temporary URLs to securely share or upload objects without exposing credentials.
  • Managing object tags to organize and classify stored data.
  • Configuring bucket policies, lifecycle rules, and CORS settings programmatically.
  • Handling multipart uploads to efficiently upload large files in parts.
  • Copying, deleting, and retrieving metadata for objects.
  • Managing bucket-level settings like versioning, logging, notifications, replication, and encryption.

For the Put Object Tagging operation specifically, this node allows users to set or update tags on an existing object within a specified bucket by providing key-value pairs in JSON format.

Properties

Name Meaning
Bucket Name Name of the S3 bucket where the object resides.
Object Key Complete path or key of the object within the bucket (e.g., folder/file.pdf).
Tags JSON object representing tags as key-value pairs to assign to the object. Example: {"Environment":"Production","Project":"MyApp"}

Output

The output JSON for the Put Object Tagging operation includes:

  • bucket: The name of the bucket where the object is tagged.
  • key: The object key that was tagged.
  • tags: The JSON object of tags that were applied.
  • message: Confirmation string indicating successful update, e.g., "Object tags updated successfully".
  • operation: The operation performed (putObjectTagging).
  • timestamp: ISO timestamp when the operation was executed.
  • success: Boolean indicating if the operation succeeded (true).

No binary data is output for this operation.

Example output snippet:

{
  "bucket": "my-bucket-name",
  "key": "folder/file.pdf",
  "tags": {
    "Environment": "Production",
    "Project": "MyApp"
  },
  "message": "Object tags updated successfully",
  "operation": "putObjectTagging",
  "timestamp": "2024-06-01T12:00:00.000Z",
  "success": true
}

Dependencies

  • Requires valid credentials for an S3-compatible service, including access key ID and secret access key, optionally session token, region, endpoint URL, and path style configuration.
  • Uses AWS SDK v3 clients internally to communicate with the S3 API.
  • The node expects proper permissions to perform tagging operations on the specified bucket and object.
  • No additional environment variables are required beyond credential setup in n8n.

Troubleshooting

  • Invalid tags JSON format: If the tags input is not valid JSON, the node throws an error "Invalid tags JSON format". Ensure the tags property is a properly formatted JSON object.
  • Access Denied / Permission errors: Insufficient permissions on the bucket or object will cause failures. Verify that the provided credentials have rights to modify object tags.
  • Object Not Found: If the specified object key does not exist in the bucket, the operation may fail. Confirm the object key is correct.
  • Network or Endpoint issues: Connection problems to the S3 endpoint can cause errors. Check network connectivity and endpoint URL correctness.
  • Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output.

Links and References

Discussion