Actions11
Overview
This node interacts with an object storage service compatible with the MinIO API. Specifically, for the "Object" resource and the "List" operation, it lists objects stored within a specified bucket. This is useful when you want to retrieve and process multiple objects from a storage bucket, such as listing files in cloud storage for further automation or data processing workflows.
Practical examples include:
- Listing all files in a backup bucket before triggering download or processing.
- Enumerating images stored in a media bucket to generate thumbnails.
- Retrieving logs stored as objects in a bucket for analysis.
Properties
| Name | Meaning |
|---|---|
| Bucket Name | The name of the bucket containing the objects to list. Can be selected from a list of existing buckets or entered manually by ID. |
| Object Name | (Not applicable for List operation) The name of a specific object in the bucket. Used only for operations other than List. |
Note: For the List operation on the Object resource, only the "Bucket Name" property is relevant and required.
Output
The node outputs a JSON array where each item represents an object found in the specified bucket. Each object typically includes metadata such as the object's key (name), size, last modified date, and possibly other attributes depending on the underlying API response.
If the node supports binary data output (not explicitly shown here), it would represent the actual content of objects; however, for the List operation, the output is metadata only.
Dependencies
- Requires connection to a MinIO-compatible object storage service.
- Needs appropriate credentials configured in n8n to authenticate against the storage service.
- The node uses internal methods for credential testing and listing resources, which depend on the configured API access.
Troubleshooting
Common issues:
- Incorrect bucket name leading to empty results or errors.
- Insufficient permissions causing authentication or authorization failures.
- Network connectivity problems preventing access to the storage endpoint.
Error messages:
- Errors indicating "bucket not found" suggest verifying the bucket name and existence.
- Authentication errors imply checking the configured API credentials.
- Timeout or network errors require ensuring the storage service is reachable from n8n.
Links and References
- MinIO Documentation
- S3 Compatible API Reference (MinIO is S3 compatible)
- n8n documentation on Resource Locators