青龙面板[Qinglong] icon

青龙面板[Qinglong]

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

Overview

This node integrates with the Qinglong Panel API to manage 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 "禁用任务" (Disable Task) operation, it allows users to disable one or more selected scheduled tasks by their IDs.

Common scenarios where this node is beneficial include:

  • Automating the management of scheduled jobs in Qinglong, such as enabling, disabling, running, or stopping tasks programmatically.
  • Bulk operations on multiple scheduled tasks to streamline maintenance workflows.
  • Integrating task control into larger automation workflows within n8n.

Practical example:

  • A user wants to temporarily disable several scheduled tasks during system maintenance. They select the tasks via the node’s multi-select property and execute the disable operation, which sends the appropriate API request to Qinglong to disable those tasks.

Properties

Name Meaning
任务列表【可多选】 List of scheduled task IDs to operate on; supports selecting multiple tasks to disable.

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

Output

The node outputs a JSON object under the json field containing a result property. This result holds the response data returned from the Qinglong API after performing the disable operation on the specified scheduled tasks.

Example output structure:

{
  "result": {
    // API response data confirming the disable operation status
  }
}

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 internal helper functions to obtain an authentication token and make HTTP requests to Qinglong endpoints.
  • The user must configure the Qinglong API credentials in n8n before using this node.

Troubleshooting

  • Common issues:

    • Invalid or expired API credentials will cause authentication failures.
    • Selecting task IDs that do not exist or have already been disabled may result in errors or no effect.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • If the operation is not implemented or recognized, the node throws an error indicating the operation is not yet supported.
    • 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 active.
    • Check network access and firewall settings.
    • Review the node’s configuration and input parameters for correctness.

Links and References

Discussion