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 securely, automating downloads, or integrating with external systems that need time-limited access to objects.

Common scenarios:

  • Sharing a file with a third party via a secure, expiring link.
  • Automating the retrieval of files from MinIO in workflows.
  • Integrating MinIO-stored assets into web applications or services without exposing credentials.

Example:
You have a PDF report stored in MinIO and want to send a download link to a client that expires after a certain period.

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 unique key (path/filename) of the object within the selected bucket.

Property Details

  • Bucket:
    • Required.
    • Can be chosen from a searchable list of available buckets or entered manually by name.
  • Key:
    • Required.
    • The exact identifier of the object you wish to generate a presigned URL for.

Output

The node outputs a JSON object with the following structure:

{
  "url": "<presigned_get_url>"
}
  • url: The generated presigned GET URL for downloading the specified object.

No binary data is output; only the URL is provided in the json field.

Dependencies

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

Troubleshooting

Common Issues:

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

  • Invalid Bucket or Key:
    If the specified bucket or key does not exist, MinIO will throw an error.
    Resolution: Double-check the bucket name and object key for typos or existence.

  • Permission Denied:
    If the credentials lack permission to access the bucket or object, the operation will fail.
    Resolution: Ensure the MinIO user has appropriate permissions for the requested action.

  • Unsupported Operation:
    Error: The operation "..." is not supported!
    Resolution: Only use supported operations as listed in the node options.

Links and References

Discussion