青龙面板[Qinglong] icon

青龙面板[Qinglong]

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

Overview

This node integrates with the Qinglong Panel API to manage scheduled tasks (crontabs) and related resources. Specifically, for the "定时任务" (Scheduled Task) resource and the "获取单个任务" (Get Single Task) operation, it retrieves detailed information about a single scheduled task by its ID.

Common scenarios where this node is useful include:

  • Automating retrieval of specific scheduled task details for monitoring or auditing.
  • Integrating Qinglong scheduled tasks data into workflows for conditional logic or reporting.
  • Fetching task metadata before performing updates or triggering executions.

Example: You want to get the configuration and status of a particular crontab job identified by its ID to decide whether to enable or disable it in your automation flow.

Properties

Name Meaning
Crontab The scheduled task to retrieve, selected either from a list of available crontabs or by specifying its ID manually.

The "Crontab" property supports two modes:

  • From List: Select a crontab from a searchable dropdown list populated dynamically.
  • ID: Enter the crontab's unique identifier as a string.

Output

The node outputs JSON data under the json.result field containing the detailed information of the requested single scheduled task. This includes all properties returned by the Qinglong API for that crontab, such as its name, schedule, command, status, and other metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Qinglong Panel API.
  • The node uses internal helper functions to obtain a valid token and make authenticated HTTP requests to Qinglong endpoints.
  • No additional external dependencies are needed beyond the configured API authentication.

Troubleshooting

  • Error: Operation not implemented
    If you select an unsupported operation for the "定时任务" resource, the node throws an error indicating the operation is not yet implemented. Ensure you choose a valid operation supported by the node.

  • Invalid Crontab ID
    Providing an invalid or non-existent crontab ID will result in an API error. Verify the ID format and existence via the Qinglong panel or by listing crontabs first.

  • Authentication Errors
    Failure to authenticate with the Qinglong API (e.g., invalid or expired API key) will cause request failures. Confirm that the API credentials are correctly configured and have sufficient permissions.

  • Network Issues
    Connectivity problems to the Qinglong API endpoint can cause timeouts or errors. Check network access and endpoint availability.

Links and References

Discussion