N8N Tools - S3 EnhancedInstall

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

The "List Buckets" operation specifically retrieves all available buckets accessible by the provided credentials. This is useful for scenarios where you want to enumerate or display all buckets in an account before performing further actions like selecting a bucket for upload or download.

Practical examples:

• Automatically list all buckets in your S3 account to populate a dropdown menu in a workflow.
• Use the list of buckets to validate bucket existence before attempting uploads or downloads.
• Combine with other operations to automate backup or data migration tasks across multiple buckets.

Properties

Note: For the "List Buckets" operation, the "Bucket Name" property is hidden and not required because listing buckets does not require specifying a bucket.

Output

The output JSON for the "List Buckets" operation contains:

• buckets: An array of bucket objects, each typically containing:
  • Name: The name of the bucket.
  • CreationDate: The date the bucket was created.
• owner: Information about the owner of the buckets.
• count: The total number of buckets returned.

Example output structure:

{
  "buckets": [
    {
      "Name": "example-bucket-1",
      "CreationDate": "2023-01-01T12:00:00Z"
    },
    {
      "Name": "example-bucket-2",
      "CreationDate": "2023-02-15T08:30:00Z"
    }
  ],
  "owner": {
    "DisplayName": "owner-name",
    "ID": "owner-id"
  },
  "count": 2,
  "operation": "listBuckets",
  "timestamp": "2024-06-01T10:00:00.000Z",
  "success": true
}

No binary data is output by this operation.

Dependencies

• Requires valid credentials for an S3-compatible service, including access key ID and secret access key.
• Supports optional session tokens and custom endpoints for non-AWS S3-compatible services.
• Uses AWS SDK v3 clients internally.
• Requires the node's credentials to be configured with appropriate permissions to list buckets.

Troubleshooting

• Common issues:

  • Invalid or missing credentials will cause authentication errors.
  • Network connectivity problems or incorrect endpoint URLs can prevent connection.
  • Insufficient permissions may result in access denied errors.

• Error messages and resolutions:

  • "Invalid Access Key ID. Please check your credentials." — Verify that the access key ID is correct.
  • "Invalid Secret Access Key. Please check your credentials." — Verify the secret access key.
  • "Access denied. Check your credentials and permissions." — Ensure the credentials have permission to list buckets.
  • "Cannot connect to endpoint. Check your endpoint URL and network connection." — Confirm network access and endpoint correctness.

• If the node throws "Unknown operation: listBuckets" error, ensure the operation parameter is correctly set.

Links and References

• AWS S3 ListBuckets API
• AWS SDK for JavaScript v3 - S3 Client
• Presigned URLs in AWS S3 (related but for other operations)

This summary focuses on the "List Buckets" operation of the node named "N8N Tools - S3 Enhanced".