Actions11
Overview
This node interacts with objects stored in buckets on a MinIO-compatible object storage service. Specifically, the "Stat" operation retrieves metadata about a specified object within a bucket. This is useful for scenarios where you need to check details such as size, last modified date, or version information of an object without downloading it.
Practical examples include:
- Verifying if an object exists and checking its properties before processing.
- Retrieving version information for versioned objects.
- Monitoring object metadata for auditing or logging purposes.
Properties
| Name | Meaning |
|---|---|
| Bucket Name | The name of the bucket containing the object. Can be selected from a list of buckets or provided as a string ID. |
| Object Name | The name (key) of the object within the bucket. Can be selected from a list of objects or provided as a string ID. |
| Options | Additional options for the stat operation. Currently supports specifying a version of the object using JSON, e.g., {versionId:"my-versionId"}. |
Output
The node outputs a JSON object containing the metadata of the specified object. This typically includes fields such as:
- Object size
- Last modified timestamp
- ETag or checksum
- Version ID (if applicable)
- Other relevant metadata returned by the MinIO API's stat call
No binary data output is produced by this operation.
Dependencies
- Requires access to a MinIO-compatible object storage service.
- Needs appropriate credentials configured in n8n to authenticate with the storage service.
- The node depends on internal methods for listing buckets and objects to support resource locators.
Troubleshooting
- Object Not Found: If the specified object or bucket does not exist, the node will likely throw an error indicating the resource was not found. Verify the bucket and object names.
- Permission Denied: Insufficient permissions or incorrect credentials can cause authentication errors. Ensure the API key or token has read access to the bucket and object.
- Invalid Version ID: When specifying a version in options, ensure the version ID is correct; otherwise, the stat call may fail.
- Empty Lists: If the bucket or object lists are empty when selecting from lists, verify connectivity and permissions to list resources.
Links and References
- MinIO Documentation
- S3 Compatible API Reference (MinIO uses S3-compatible APIs)