ToolBox icon

ToolBox

陈先生工具箱

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.

Typical use cases include:

  • Automating the upload of images or other binary files to Tencent Cloud COS for storage and later retrieval.
  • Integrating file uploads into workflows that require cloud storage as part of data processing or content management pipelines.

For example, a user might automate uploading screenshots or generated reports directly from an application workflow to a COS bucket for backup or sharing purposes.

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 within the bucket where the file should be stored (optional).
文件属性名称 (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 status returned by the Tencent COS API.

If the node processes multiple items, each output JSON corresponds to one uploaded file's metadata. The output is wrapped with execution metadata linking it to the original input item.

No binary data is output by this node; it only returns JSON describing the upload results.

Dependencies

  • Requires valid credentials for Tencent Cloud API access, specifically an API key credential with permissions to access COS.
  • The node uses internal helper methods to handle binary data extraction and API calls.
  • The Tencent Cloud COS SDK or equivalent API client is used internally to perform the file upload.
  • Users must configure the node with correct bucket names, regions, and ensure the provided credentials have sufficient permissions.

Troubleshooting

  • Common issues:

    • Incorrect or missing bucket name or region can cause upload failures.
    • Invalid or expired API credentials will prevent authentication.
    • Specifying a wrong dataPropertyName may lead to errors if the binary data cannot be found in the input.
    • Network connectivity issues can cause timeouts or failed uploads.

  • Error messages:

    • Authentication errors usually indicate invalid credentials; verify and update the API key.
    • "Binary data not found" errors suggest the specified dataPropertyName does not exist or is empty in the input.
    • API errors from Tencent Cloud may include permission denied or bucket not found; check bucket existence and access rights.

To resolve these, double-check all input parameters, ensure credentials are valid, and confirm the binary data is correctly attached to the input item.

Links and References

Discussion