Actions11
Overview
This node allows you to create a new bucket in an object storage service compatible with the MinIO API. Buckets are containers for storing objects (files), and creating buckets is a fundamental operation when organizing data storage.
Common scenarios where this node is useful include:
- Setting up new storage containers programmatically as part of automated workflows.
- Organizing files by creating separate buckets for different projects, clients, or data types.
- Managing cloud storage infrastructure directly from n8n without manual intervention.
For example, you might use this node to create a bucket named "project-data" in the "us-east-1" region before uploading project files into it.
Properties
| Name | Meaning |
|---|---|
| Bucket Name | The name of the bucket to create. This is a required string input specifying the bucket's identifier. |
| Region | The geographical region where the bucket will be created. Defaults to "us-east-1". |
| Bucket Options | Additional JSON-formatted options to customize bucket creation. These options depend on the underlying storage service's API. |
Output
The node outputs JSON data representing the result of the bucket creation operation. This typically includes metadata about the newly created bucket such as its name, location, and any other relevant details returned by the storage service.
No binary data output is produced by this node.
Dependencies
- Requires access to an object storage service compatible with the MinIO API.
- Needs appropriate credentials configured in n8n to authenticate requests to the storage service.
- The "Region" property should correspond to a valid region supported by the storage backend.
Troubleshooting
- Bucket name conflicts: Attempting to create a bucket with a name that already exists may cause errors. Ensure bucket names are unique within the scope of your storage account.
- Invalid region: Specifying an unsupported or incorrect region can lead to failures. Verify the region value matches one supported by your storage provider.
- Insufficient permissions: Errors related to authorization usually indicate missing or invalid credentials. Confirm that the API key or authentication token has permission to create buckets.
- Malformed JSON in Bucket Options: If the JSON provided in the "Bucket Options" field is invalid, the node may throw parsing errors. Validate JSON syntax before execution.
Links and References
- MinIO Documentation – Official documentation for MinIO object storage.
- Amazon S3 Bucket Creation – Since MinIO is S3-compatible, AWS S3 docs provide useful context on bucket concepts and options.