Overview
This node, named "ToolBox," provides integration with Tencent Cloud services, specifically focusing on uploading files to Tencent Cloud Object Storage (COS) and web scraping tools. The operation "单个文件上传" (single file upload) under the resource "腾讯云图床工具" (Tencent Cloud Image Hosting Tool) allows users to upload a single binary file to a specified COS bucket.
Common scenarios for this node include:
- Uploading images or other binary files from workflows directly into Tencent Cloud COS for storage or further processing.
- Automating backup or archival of files by pushing them to cloud storage.
- Integrating file uploads as part of larger automation pipelines that require cloud-hosted assets.
Practical example:
- A user has an image file generated or processed in a previous node and wants to upload it to a specific COS bucket and path for hosting or sharing. This node takes the binary data, authenticates with Tencent Cloud using provided credentials, and uploads the file accordingly.
Properties
| Name | Meaning |
|---|---|
| 存储桶名称 (Bucket) | The name of the COS storage bucket where the file will be uploaded. |
| 存储区域 (Region) | The geographic region where the COS bucket is located (e.g., "ap-beijing"). |
| 存储路径 (path) | The path inside the bucket where the file should be stored (folder or key prefix). |
| 文件属性名称 (dataPropertyName) | The name of the binary property in the input item that contains the file data (default: "data"). |
Output
The node outputs JSON data representing the result of the upload operation. This typically includes metadata about the uploaded file such as its URL, key, or confirmation details returned by Tencent Cloud COS.
- The output is structured as an array of JSON objects, each corresponding to an input item processed.
- If the node processes multiple items, each item's upload result is included separately.
- Binary data is not outputted but consumed as input; the node focuses on returning upload metadata.
Dependencies
- Requires valid Tencent Cloud API credentials with permissions to access COS buckets.
- The node expects these credentials to be configured in n8n as an API key credential (referred generically).
- No additional external dependencies beyond Tencent Cloud COS SDK usage bundled internally.
- Proper network access to Tencent Cloud COS endpoints is necessary.
Troubleshooting
Common issues:
- Incorrect or missing COS bucket name or region can cause upload failures.
- Invalid or expired API credentials will prevent authentication.
- Specifying a wrong binary property name (
dataPropertyName) may lead to errors finding the file data. - Network connectivity issues to Tencent Cloud endpoints.
Error messages and resolutions:
- Authentication errors: Verify API credentials are correct and have sufficient permissions.
- File not found or invalid binary data: Check that the input item contains binary data under the specified property name.
- Bucket or region errors: Confirm the bucket exists in the specified region and the names are correctly spelled.
- General upload failure: Review network connectivity and Tencent Cloud service status.