青龙面板[Qinglong] icon

青龙面板[Qinglong]

青龙面板计划任务节点.详细API请参考:https://qinglong.online/api/

Overview

This node integrates with the Qinglong Panel API to manage and control scheduled tasks (crontabs) and other related resources such as subscriptions, environment variables, configurations, scripts, dependencies, logs, and system settings. Specifically, for the "定时任务" (Scheduled Task) resource and the "运行任务" (Run Task) operation, it allows users to trigger the execution of one or multiple scheduled tasks by their IDs.

Common scenarios where this node is beneficial include:

  • Automating the manual triggering of scheduled jobs outside their normal schedule.
  • Managing task execution programmatically within a workflow.
  • Integrating Qinglong scheduled tasks with other systems or triggers in n8n.

Practical example:

  • A user wants to run specific scheduled tasks immediately after a certain event occurs (e.g., after a data import finishes). They can use this node to select the tasks by their IDs and run them on demand.

Properties

Name Meaning
任务列表【可多选】 List of scheduled task IDs to operate on; supports selecting multiple tasks to run, stop, enable, disable, delete, pin, or unpin.

The property "任务列表【可多选】" ("Task List [multi-select]") lets users pick one or more scheduled tasks by their IDs. The options are dynamically loaded from the Qinglong API to reflect current tasks.

Output

The node outputs the JSON response returned by the Qinglong API for the requested operation under the json.result field of the first item in the output array.

For the "运行任务" operation, this typically includes confirmation or status information about the triggered run action on the selected scheduled tasks.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the Qinglong Panel API.
  • The node uses the Qinglong API endpoints under /open/crons/run for running tasks.
  • Proper configuration of the Qinglong API credentials in n8n is necessary.
  • Network access to the Qinglong API endpoint must be available.

Troubleshooting

  • Common issues:

    • Invalid or expired API credentials will cause authentication failures.
    • Selecting task IDs that do not exist or have been deleted may result in errors.
    • Network connectivity problems to the Qinglong API server will prevent execution.
  • Error messages:

    • If an unsupported operation is selected, the node throws an error indicating the operation is not implemented.
    • API errors from Qinglong are propagated and should be checked for details like permission issues or invalid parameters.
  • Resolutions:

    • Verify and update the API key credential.
    • Ensure the selected task IDs are valid and currently exist.
    • Check network connectivity and firewall settings.
    • Confirm the operation name matches supported actions.

Links and References

Discussion