青龙面板[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 "取消置顶" (Unpin) operation, it allows users to unpin one or more selected scheduled tasks from the QingLong panel.

Common scenarios where this node is beneficial include:

  • Automating management of scheduled tasks in QingLong, such as enabling, disabling, running, stopping, pinning, or unpinning tasks.
  • Bulk operations on multiple scheduled tasks by selecting them via their IDs.
  • Integrating QingLong task management into larger workflows for DevOps automation or server maintenance.

Practical example:

  • A user wants to programmatically remove the "pinned" status from several scheduled tasks to declutter the QingLong dashboard. They select the tasks by their IDs and use this node's "取消置顶" operation to unpin them in one go.

Properties

Name Meaning
任务列表【可多选】 List of scheduled task IDs to operate on; supports multi-selection. These are the tasks to be unpinned.

Output

The node outputs a JSON object under the json field containing the result returned by the QingLong API for the unpin operation. This typically includes success status and any relevant messages or data returned by the API.

Example output structure:

{
  "result": {
    // API response data about the unpin operation
  }
}

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/unpin with HTTP PUT method.
  • Proper configuration of the QingLong API credentials in n8n is necessary.
  • The node depends on internal helper functions to obtain tokens and make authenticated requests.

Troubleshooting

  • Common issues:

    • Invalid or expired API token: Ensure the API key credential is valid and has proper permissions.
    • Empty or incorrect task ID list: Verify that the selected task IDs exist and are correct.
    • Network connectivity problems: Confirm that the n8n instance can reach the QingLong API endpoint.

  • Error messages:

    • "任务模块的取消置顶操作暂未实现" ("The unpin operation for the task module is not yet implemented"): This would indicate a missing implementation, but based on the code, this operation is implemented.
    • API errors returned from QingLong will be wrapped and thrown as node errors; check the error message for details.

  • Resolution tips:

    • Double-check the input property "任务列表【可多选】" to ensure valid task IDs are provided.
    • Review API credentials and refresh if needed.
    • Inspect network logs to verify successful API calls.

Links and References

Discussion