VolcEngineTos Node icon

VolcEngineTos Node

Interact with VolcEngine Cloud Object Storage (TOS/TOD)

Overview

The node interacts with VolcEngine Cloud Object Storage (TOS), enabling various file and bucket operations. Specifically, the Upload Binary File operation allows users to upload binary data from n8n into a specified path in TOS. This is useful for automating file storage workflows such as backing up files, uploading generated reports, or saving images and documents directly from automation processes.

Practical examples include:

  • Uploading user-generated content or logs from an application workflow.
  • Storing processed images or PDFs generated during automation.
  • Automating backups of configuration files or datasets to cloud storage.

Properties

Name Meaning
File Path The path and name where the file will be stored in VolcEngine TOS.
Binary Property The name of the binary property in the input data that contains the file content to upload. Default is "data".
Make Public Boolean flag indicating whether the uploaded file should be publicly accessible.

Output

The node outputs JSON data containing information about the uploaded file, typically including metadata such as the file URL or confirmation of successful upload. Additionally, if applicable, it can output binary data paired with the JSON result, representing the uploaded file content.

Dependencies

  • Requires an API key credential for VolcEngine TOS with accessKey, secretKey, region, endpoint, and bucket configured.
  • Uses the official VolcEngine TOS SDK (@volcengine/tos-sdk) for interacting with the cloud storage service.
  • The node depends on proper configuration of credentials within n8n to authenticate requests.

Troubleshooting

  • No credentials returned!: This error occurs if the node cannot retrieve the required API authentication credentials. Ensure that the VolcEngine TOS API credentials are correctly set up in n8n.
  • File upload failures: May happen due to incorrect file paths, insufficient permissions, or network issues. Verify the file path is valid and the credentials have write access to the target bucket.
  • Binary property not found: If the specified binary property does not exist in the input data, the upload will fail. Confirm the binary property name matches the input data structure.
  • Make Public flag ignored: If the uploaded file is not publicly accessible despite setting this flag, check bucket policies and permissions in VolcEngine TOS.

Links and References

Discussion