MinIO icon

MinIO

MinIO operation

Overview

This node generates a presigned PUT URL for an object in a MinIO bucket. A presigned PUT URL allows users or external systems to upload files directly to a specified location in a MinIO bucket without needing direct access to credentials. This is useful for securely allowing uploads from clients, web applications, or third-party services.

Practical examples:

  • Allowing users to upload profile images directly to your storage.
  • Enabling external partners to upload large datasets without exposing your MinIO credentials.
  • Integrating with web forms or mobile apps that need to upload files securely.

Properties

Display Name Type Description
Bucket Resource Locator The target MinIO bucket where the object will be uploaded. Can be selected from a list or entered by name.
Key String The unique key (path/filename) for the object within the bucket.

Output

The node outputs a JSON object with the following structure:

{
  "url": "<presigned_put_url>"
}
  • url: The generated presigned PUT URL. Use this URL to upload a file directly to the specified bucket and key.

Dependencies

  • MinIO server: You must have access to a running MinIO instance.
  • API Credentials: Requires valid MinIO credentials configured in n8n under minioCredentialsApi.
  • n8n Configuration: No additional configuration required beyond credentials.

Troubleshooting

  • Missing Credentials:
    Error: "No credentials got returned!"
    Solution: Ensure you have set up and selected valid MinIO credentials in the node.

  • Invalid Bucket or Key:
    If the bucket does not exist or the key is invalid, the node may throw an error from the MinIO client.
    Solution: Double-check the bucket name and key value.

  • Operation Not Supported:
    Error: "The operation \"<operation>\" is not supported!"
    Solution: Make sure you select a supported operation ("Presigned PUT URL").

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

Links and References

Discussion