Actions7
Overview
This node interacts with VolcEngine Cloud Object Storage (TOS/TOD) to perform various file and bucket operations. Specifically, the List Files operation allows users to retrieve a list of files stored in a specified TOS bucket. This is useful for scenarios where you want to browse or manage files programmatically, such as syncing files, auditing storage contents, or filtering files by certain criteria.
Practical examples:
- Listing all files under a specific folder prefix to process them further.
- Paginating through large sets of files using markers.
- Grouping files by common prefixes using delimiters to simulate folder structures.
Properties
| Name | Meaning |
|---|---|
| Prefix Filter | Filter files by prefix (optional). Only files whose names start with this prefix are listed. |
| Maximum Number | Maximum number of files to return (default: 1000). Limits the number of results returned. |
| Delimiter | Delimiter for grouping files (optional). Used to group files that share a common prefix up to the delimiter, simulating folders. |
| Marker | Start listing from this marker (for pagination, optional). Allows continuing listing from a specific point. |
Output
The output is an array of items, each containing a json field with metadata about the files listed. The structure typically includes file names, sizes, timestamps, and other relevant attributes returned by the TOS API for each file.
No binary data is output by this operation since it only lists metadata about files rather than their content.
Dependencies
- Requires an API key credential for VolcEngine TOS with access keys, secret keys, region, endpoint, and bucket name configured.
- Uses the official VolcEngine TOS SDK (
@volcengine/tos-sdk) to interact with the cloud storage service. - The node expects proper configuration of credentials within n8n to authenticate requests.
Troubleshooting
No credentials returned!
This error occurs if the node cannot find or access the required API authentication credentials. Ensure that the VolcEngine TOS API credentials are correctly set up in n8n.API errors during listing
Errors from the TOS service (e.g., invalid bucket name, permission denied) will be thrown. Check that the bucket exists, the credentials have sufficient permissions, and the parameters like prefix or marker are valid.Empty results
If no files are returned, verify that the prefix filter is correct and that the bucket contains files matching the criteria.Pagination issues
When using the marker for pagination, ensure the marker value is obtained from a previous listing response to continue correctly.