N8N Tools - S3 EnhancedInstall

Overview

This node provides enhanced operations for managing and interacting with S3-compatible object storage services. It supports a wide range of bucket and object management features, including creating and deleting buckets, uploading and downloading objects, managing access control lists (ACLs), configuring bucket policies, lifecycle rules, replication, encryption, CORS, notifications, multipart uploads, and more.

The "Put Bucket Replication" operation specifically allows users to set or update the replication configuration of an S3 bucket. This is useful for scenarios where data needs to be automatically replicated across different regions or accounts for redundancy, compliance, or disaster recovery purposes.

Practical example:
A user wants to enable cross-region replication on their S3 bucket to ensure that all objects uploaded to the primary bucket are asynchronously copied to a secondary bucket in another AWS region. They can use this node's "Put Bucket Replication" operation to provide the necessary replication configuration JSON, specifying roles and replication rules, thereby automating the setup without manual intervention in the AWS console.

Properties

Example of Replication Configuration JSON structure (placeholder):

{
  "Role": "arn:aws:iam::123456789012:role/replication-role",
  "Rules": []
}

Output

The output JSON contains the following fields:

• bucket: The name of the bucket for which the replication configuration was set.
• replicationConfiguration: The replication configuration JSON object that was applied.
• message: A confirmation string indicating successful update, e.g., "Bucket replication updated successfully".
• operation: The operation performed, here it will be "putBucketReplication".
• timestamp: ISO timestamp when the operation was executed.
• success: Boolean indicating if the operation succeeded (true).

If the operation fails and continueOnFail is enabled, the output will contain an error message and success set to false.

Dependencies

• Requires an S3-compatible service endpoint accessible via credentials that have permissions to modify bucket replication configurations.
• Needs an API key credential with sufficient permissions to perform replication configuration updates.
• Uses AWS SDK clients internally to communicate with the S3 service.
• No additional environment variables are explicitly required beyond standard credential configuration.

Troubleshooting

• Invalid replication configuration JSON format:
  If the provided replication configuration JSON is malformed, the node throws an error indicating invalid JSON format. Ensure the JSON is correctly structured and valid.

• Access Denied / Permission errors:
  Insufficient permissions on the provided credentials may cause failures. Verify that the API key has the necessary rights to put replication configurations on the target bucket.

• Bucket not found or incorrect bucket name:
  Double-check the bucket name input; misspelled or non-existent buckets will cause errors.

• Network or endpoint issues:
  Connection problems to the S3 endpoint will result in connection errors. Confirm network connectivity and correct endpoint URL.

• General AWS SDK errors:
  Errors from the underlying AWS SDK are surfaced with messages. Review these messages for clues and verify your configuration accordingly.

Links and References

• AWS S3 Replication Configuration Documentation
• AWS SDK for JavaScript v3 - PutBucketReplicationCommand
• Amazon S3 Concepts - Cross-Region Replication