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 operations for interacting with S3-compatible object storage services. It supports a wide range of bucket and object management features, including generating presigned URLs for secure temporary access, multipart uploads for large files, managing bucket policies, tags, lifecycle rules, and more.

Specifically, the Restore Object operation allows users to initiate the restoration of archived objects stored in Glacier or similar archival storage classes. This is useful when you need to temporarily retrieve an archived object for access or processing.

Common scenarios:

  • Restoring an archived file from Glacier storage to make it accessible again.
  • Automating archival retrieval workflows in data pipelines.
  • Managing lifecycle and archival states of objects programmatically.

Example use case:
You have backups stored in Glacier and want to restore a specific backup file for 7 days using the Standard retrieval tier. You configure the restore request JSON accordingly and trigger the restore operation via this node.


Properties

Name Meaning
Bucket Name Name of the S3 bucket containing the object to restore.
Object Key Complete path/key of the object within the bucket that you want to restore.
Restore Request JSON configuration specifying restore parameters such as duration (Days) and retrieval tier (GlacierJobParameters.Tier). Example: {"Days":7,"GlacierJobParameters":{"Tier":"Standard"}}

Output

The output JSON object for the Restore Object operation includes:

  • bucket: The name of the bucket where the object resides.
  • key: The key/path of the object being restored.
  • restoreRequest: The parsed JSON object representing the restore request parameters.
  • message: Confirmation string indicating the restore operation was initiated successfully.
  • Additional metadata fields:
    • operation: The operation name ("restoreObject").
    • timestamp: ISO timestamp of when the operation was executed.
    • success: Boolean flag indicating success (true).

This output confirms that the restore request has been sent to the S3 service but does not indicate completion of the restore process itself, which may take time depending on the retrieval tier.


Dependencies

  • Requires an S3-compatible storage service supporting the RestoreObject API.
  • Needs credentials with permissions to perform restore operations on the specified bucket/object.
  • The node uses AWS SDK clients internally to communicate with the S3 service.
  • Properly configured API authentication credentials must be provided in n8n for the node to function.

Troubleshooting

  • Invalid restore request JSON format:
    If the restore request JSON is malformed, the node throws an error indicating invalid JSON format. Ensure the JSON is valid and matches expected structure.

  • Access Denied / Permission errors:
    Insufficient permissions on the bucket or object will cause failures. Verify that the credentials used have the necessary rights to restore objects.

  • Object not found:
    If the specified bucket or key does not exist, the operation will fail. Double-check the bucket name and object key.

  • Restore operation delay:
    Restoration from Glacier can take several hours depending on the tier. The node only initiates the request; actual availability depends on the storage backend.

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


Links and References

Discussion