N8N Tools - S3 EnhancedInstall

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 lifecycle, CORS, policies, tagging, and more.

The "Get Object Tagging" operation specifically retrieves the tags associated with a particular object stored in an S3 bucket. This is useful for workflows that need to read metadata tags for objects to make decisions, audit data, or manage resources based on tagging.

Common scenarios:

• Retrieving metadata tags of an object to determine its classification or processing rules.
• Auditing or reporting on object tags for compliance or organizational purposes.
• Integrating with other systems that rely on object tags for automation or categorization.

Practical example:
A workflow that processes uploaded documents might first get the tags of each document to check if it is marked as "Confidential" or "Public" and route the document accordingly.

Properties

These properties are required inputs to specify which object's tags should be retrieved.

Output

The output JSON contains the following structure:

{
  "bucket": "string",       // The bucket name provided in input
  "key": "string",          // The object key provided in input
  "tags": {                 // An object containing key-value pairs representing the tags of the object
    "TagKey1": "TagValue1",
    "TagKey2": "TagValue2"
  }
}

• tags is a dictionary mapping tag keys to their corresponding values.
• If the object has no tags, this will be an empty object.

No binary data is output by this operation.

Dependencies

• Requires connection credentials for an S3-compatible service (access key, secret key, optional session token, region, endpoint).
• Uses AWS SDK v3 for JavaScript under the hood to communicate with the S3 API.
• The node expects valid permissions to perform the GetObjectTagging API call on the specified bucket and object.

Troubleshooting

Common issues:

• Access Denied / Permission Errors:
  Occurs if the credentials do not have permission to read object tags. Ensure the IAM policy or equivalent permissions allow s3:GetObjectTagging.

• Invalid Bucket or Object Key:
  If the bucket or key does not exist, the operation will fail. Verify the bucket name and object key are correct.

• Malformed Input:
  Missing required parameters like bucket or key will cause errors.

Error messages and resolutions:

• "S3 operation failed: Access Denied"
  Check your credentials and permissions for the bucket and object.

• "S3 operation failed: NoSuchBucket" or "NoSuchKey"
  Confirm the bucket and object key exist.

• "Invalid tags JSON format" (not applicable here but common in tagging operations)
  When setting tags, ensure JSON is well-formed.

Links and References

• AWS S3 GetObjectTagging API
• AWS SDK for JavaScript v3 - S3 Client
• Amazon S3 Object Tagging Overview