青龙面板[Qinglong] icon

青龙面板[Qinglong]

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

Actions64

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 "启用任务" (Enable Task) operation, it enables one or more selected scheduled tasks by sending a request to the QingLong API to activate those tasks.

Common scenarios where this node is beneficial include:

  • Automating the enabling of scheduled jobs in QingLong from an n8n workflow.
  • Managing multiple scheduled tasks programmatically without manual intervention.
  • Integrating task management into broader automation pipelines that require dynamic control over job execution.

Practical example:

  • A user wants to enable several disabled scheduled tasks after a maintenance window automatically. This node can be configured to select those tasks and enable them via the QingLong API.

Properties

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

The property "任务列表【可多选】" allows users to select one or more scheduled tasks (crontabs) by their IDs. The options are dynamically loaded from the QingLong API to present available 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 of the tasks being enabled or any relevant status messages from the API.

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 the QingLong API endpoints.
  • The QingLong API base URL and credentials must be properly configured in n8n for successful communication.

Troubleshooting

  • Common issues:

    • Invalid or expired API credentials will cause authentication failures.
    • Selecting invalid or non-existent task IDs may result in errors from the API.
    • Network connectivity issues between n8n and the QingLong server can cause request failures.

  • Error messages:

    • If an unsupported operation is selected, the node throws an error indicating the operation is not implemented.
    • API errors returned by QingLong are propagated and can include messages about permission issues, invalid parameters, or server errors.

  • Resolutions:

    • Verify and update the API key credential if authentication fails.
    • Ensure the selected task IDs exist and are valid.
    • Check network connectivity and firewall settings.
    • Confirm the operation name matches supported operations for the resource.

Links and References

Discussion