跳到主要内容

分页查询

GET/cron

请求

名称类型必填描述
pagestring指定页数,默认1
sizestring指定分页大小数量,默认20
typestring任务类型过滤,当前固定分为 usersystem
activestring<'0' | '1'>启用/禁用状态过滤 1 启用 | 0 禁用,默认不过滤
tagsstring任务标签过滤(仅限系统任务,取自 bind 值的中间字段,可通过 bindGroup 获取,支持多个用英文逗号分隔)
orderBystring<'sort' | 'last_runtime' | 'last_run_use'>指定排序字段,默认 sort
orderstring<'0' | '1'>指定排序方式 0 升序 | 1 降序,默认降序

响应

名称类型描述
dataobject[]数据项
pagenumber当前页码
sizenumber每页数据量
totalnumber数据总量

数据项(主要为数据库 tasks 表字段)

名称类型描述
idnumber唯一标识
namestring任务名称
typestring任务类型,当前固定分为 user 和 system
cronstring定时规则(5位或6位的定时表达式)
shellstring执行的命令
activenumber<0 | 1>状态 1 启用 | 0 禁用
configstring<object>高级配置
tagsstring任务标签
last_runtimestring最后一次运行的时间
last_run_usenumber最后一次运行的时长(单位秒,精确到小数点后3位)
sortnumber在分页中的位置序号(正整数),默认按照先后顺序递增
create_timestring任务创建时间
remarkstring备注
bindstring后端用于关联底层内容的参数(仅系统任务使用)
is_runningboolean当前运行状态(任务是否正在运行)
示例
{
"data": [
{
"id": 2,
"name": "系统测试任务",
"type": "system",
"cron": "30 */2 * * *",
"shell": "arcadia run example.js",
"active": 1,
"config": "",
"tags": "",
"last_runtime": null,
"last_run_use": null,
"sort": 1,
"create_time": "2024-01-01 00:00:00",
"remark": "",
"bind": "",
"is_running": false
},
{
"id": 1,
"name": "用户测试任务",
"type": "user",
"cron": "0 0 * * *",
"shell": "arcadia rmlog",
"active": 0,
"config": "",
"tags": "",
"last_runtime": "2024-01-01 00:00:00",
"last_run_use": 1,
"sort": 1,
"create_time": "2024-01-01 00:00:00",
"remark": "",
"bind": "",
"is_running": true
},
...
],
"total": 5,
"page": 1,
"size": 20
}

默认倒序返回