Overview

This node provides enhanced integration with S3-compatible 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 like CORS, lifecycle, policies, tagging, versioning, and acceleration.

Common scenarios where this node is beneficial include:

• Automating file uploads and downloads to/from S3 buckets.
• Managing bucket configurations programmatically (e.g., setting CORS rules or lifecycle policies).
• Generating presigned URLs to securely share objects without exposing credentials.
• Handling large file uploads efficiently using multipart upload.
• Retrieving or modifying bucket/object metadata, ACLs, tags, and policies.
• Enabling or disabling transfer acceleration on buckets.

Practical example:
You want to generate a temporary URL that allows a user to download a private file from your S3 bucket without requiring them to have AWS credentials. Using the "Generate Presigned URL" operation, you can create a URL valid for a limited time that grants access to the specified object.

Properties

For the "Get Bucket Accelerate" operation specifically:

(Note: The provided input properties JSON only includes "Bucket Name" for this operation.)

Output

The output is a JSON object containing the result of the requested operation. For the Get Bucket Accelerate operation, the output structure is:

{
  "bucket": "string",       // The bucket name queried
  "status": "string"        // The accelerate configuration status, e.g., "Enabled" or "Suspended"
}

Additional fields included in all outputs are:

• operation: The name of the performed operation (e.g., "getBucketAccelerate").
• timestamp: ISO string timestamp when the operation was executed.
• success: Boolean indicating if the operation succeeded.

If an error occurs and "Continue On Fail" is enabled, the output will contain:

{
  "error": "Error message",
  "success": false,
  "operation": "operationName",
  "timestamp": "ISO timestamp"
}

This node does not output binary data for the "Get Bucket Accelerate" operation.

Dependencies

• Requires an S3-compatible storage service endpoint.
• Requires credentials with appropriate permissions (access key ID and secret access key) to perform bucket operations.
• Uses AWS SDK v3 clients internally for communication.
• Requires n8n credentials configured with access to the target S3-compatible service.
• No additional environment variables are explicitly required beyond credential setup.

Troubleshooting

Common Issues

• Invalid Credentials: If the access key ID or secret access key is incorrect, connection tests and operations will fail.
• Access Denied: Insufficient permissions on the bucket or object will cause errors.
• Invalid Bucket Name: Specifying a non-existent or incorrectly named bucket will result in errors.
• Network/Endpoint Issues: Incorrect endpoint URLs or network connectivity problems will prevent successful API calls.
• Malformed JSON Inputs: For operations requiring JSON inputs (not applicable here), invalid JSON will cause errors.

Error Messages and Resolutions

• "S3 operation failed: <message>" — General failure during the operation; check the detailed message for specifics.
• "Invalid Access Key ID. Please check your credentials." — The access key ID is wrong; verify credentials.
• "Invalid Secret Access Key. Please check your credentials." — The secret key is wrong; verify credentials.
• "Access denied. Check your credentials and permissions." — Permissions issue; ensure the credentials have rights for the operation.
• "Cannot connect to endpoint. Check your endpoint URL and network connection." — Network or endpoint misconfiguration; verify endpoint URL and network access.

Links and References

• AWS S3 Transfer Acceleration Documentation
• AWS SDK for JavaScript v3 - S3 Client
• n8n Documentation - Creating Custom Nodes
• Amazon S3 Bucket Configuration Concepts

Summary for Resource: Default, Operation: Get Bucket Accelerate

This node operation retrieves the current transfer acceleration status of a specified S3 bucket, which indicates whether accelerated data transfers are enabled or suspended. This feature can improve upload and download speeds by routing traffic through optimized network paths.

Input requires the bucket name. The output returns the bucket name and its acceleration status.

This operation is useful for monitoring or auditing bucket acceleration settings within automated workflows.