MinIO icon

MinIO

MinIO operation

Overview

This node generates a presigned GET URL for an object stored in a MinIO bucket. A presigned GET URL allows temporary, secure access to download a specific object from MinIO without requiring direct credentials. This is useful for sharing files with external users or systems, automating downloads, or integrating MinIO-stored content into other workflows.

Example scenarios:

  • Sharing a file with a client via a time-limited link.
  • Automating the retrieval of backups or reports stored in MinIO.
  • Integrating MinIO object access into webhooks or third-party services.

Properties

Display Name Type Meaning
Bucket Resource Locator The MinIO bucket containing the object. You can select from a list or enter the name.
Key String The key (path/filename) of the object within the selected bucket.

Output

The node outputs a JSON object with the following structure:

{
  "url": "<presigned_get_url>"
}
  • url: The generated presigned GET URL that provides temporary access to the specified object.

Dependencies

  • MinIO server: The node requires access to a running MinIO instance.
  • Credentials: n8n credentials of type minioCredentialsApi must be configured with appropriate access and secret keys.
  • n8n configuration: No additional environment variables are required beyond standard credential setup.

Troubleshooting

  • Missing Credentials:
    Error message: No credentials got returned!
    Resolution: Ensure you have set up and selected valid MinIO credentials in n8n.

  • Invalid Bucket or Key:
    Error message: May include details from MinIO such as "The specified bucket does not exist" or "The specified key does not exist".
    Resolution: Double-check the bucket and key values. Use the resource locator's list mode to avoid typos.

  • Unsupported Operation:
    Error message: The operation "..." is not supported!
    Resolution: Make sure you have selected the correct operation ("Presigned GET URL").

  • Connection Issues:
    Errors related to network or authentication may occur if the MinIO server is unreachable or credentials are incorrect.

Links and References

Discussion