青龙面板[Qinglong] icon

青龙面板[Qinglong]

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

Actions64

Overview

This node integrates with the QingLong Panel API to manage scheduled tasks (cron jobs) and other related resources. Specifically, for the "定时任务" (Scheduled Task) resource and the "更新任务" (Update Task) operation, it allows users to update existing cron jobs by sending updated task details such as command, schedule, name, labels, and dependencies.

Common scenarios where this node is beneficial include:

  • Automating updates to scheduled scripts or commands without manual intervention.
  • Dynamically modifying cron expressions or task parameters based on workflow logic.
  • Managing complex task dependencies by updating pre/post task relationships.

For example, you can use this node to update a scheduled task's execution command or change its timing expression programmatically within an automation workflow.

Properties

Name Meaning
请求Body JSON object containing the update details of the scheduled task. It includes:
- id: Task ID (number)
- command: Command to execute (string)
- schedule: Cron expression (string)
- name: Task name (string)
- labels: Labels/tags (array of strings)
- sub_id: Subtask ID (number)
- extra_schedules: Additional scheduling rules (any array)
- task_before: Preceding task (string)
- task_after: Following task (string)

Output

The node outputs the result of the API call in the json field under the property result. This typically contains the response from the QingLong API after attempting to update the scheduled task, which may include success confirmation or error details.

No binary data output is involved in this operation.

Example output structure:

{
  "result": {
    // API response content here, e.g., success message or updated task info
  }
}

Dependencies

  • Requires an API key credential for authenticating with the QingLong Panel API.
  • The node uses internal helper functions to obtain authentication tokens and make HTTP requests to QingLong endpoints.
  • No additional external services are required beyond access to the QingLong API.

Troubleshooting

  • Common issues:

    • Invalid or missing task ID in the request body will cause the update to fail.
    • Incorrect cron expression format may be rejected by the API.
    • Insufficient permissions or invalid API credentials will result in authentication errors.
    • Network connectivity issues to the QingLong API endpoint.

  • Error messages:

    • "任务模块的crons_update操作暂未实现" ("Task module's crons_update operation not implemented") — This should not occur as the operation is implemented; if seen, verify the node version.
    • API errors returned from QingLong will be passed through; check the result field for detailed error messages.

  • Resolution tips:

    • Ensure the id field in the request body matches an existing scheduled task.
    • Validate the cron expression syntax before sending.
    • Confirm that the API key credential is correctly configured and has necessary permissions.
    • Test network connectivity to the QingLong API server.

Links and References

Discussion