MinIO icon

MinIO

MinIO operation

Actions9

Overview

This node provides integration with MinIO, an object storage service compatible with Amazon S3 APIs. It allows users to perform operations on objects within MinIO buckets, such as generating presigned URLs for GET and PUT requests or removing objects from a bucket. This is useful in workflows where you need to securely share access to files, upload new files, or manage stored data programmatically.

Common scenarios:

  • Generating a temporary download link (presigned GET URL) for a file stored in MinIO.
  • Creating a temporary upload link (presigned PUT URL) so external systems can upload files without direct credentials.
  • Deleting files from a MinIO bucket as part of automated cleanup or data management processes.

Practical examples:

  • Automate sharing of large files with clients by generating expiring download links.
  • Allow users to upload documents directly to your storage via a secure, time-limited URL.
  • Remove outdated backup files from storage after processing.

Properties

Display Name Type Meaning
Bucket resourceLocator The target MinIO bucket. You can select from a list or enter the bucket name manually.
Key string The key (path/filename) of the object within the selected bucket.

Output

  • For Presigned GET URL and Presigned PUT URL operations:
    • The output will include a url field in the json object, containing the generated presigned URL.
      {
  "url": "https://minio.example.com/bucket/key?X-Amz-Algorithm=..."
}
  • For Remove Object operation:
    • No additional fields are added to the output; the operation simply confirms successful deletion.

Dependencies

  • External Service: Requires access to a running MinIO server.
  • Credentials: Needs valid MinIO API credentials configured in n8n (minioCredentialsApi).
  • n8n Configuration: Ensure the MinIO credentials are set up in the n8n credential store.

Troubleshooting

  • Missing Credentials:
    Error: No credentials got returned!
    Resolution: Make sure you have created and selected valid MinIO credentials in the node configuration.

  • Operation Not Supported:
    Error: The operation "<operation>" is not supported!
    Resolution: Check that you have selected a valid operation from the dropdown.

  • MinIO API Errors:
    Any errors thrown by the MinIO client (e.g., invalid bucket/key, permission issues) will be surfaced as node errors.
    Resolution: Double-check the bucket name, key, and permissions for the provided credentials.

Links and References

Discussion