更新
POST
Tokenheader
api-token<token>32位令牌,在控制面板《个人设置 - 令牌管理》页面获取
application/json- body
更新定时任务请求体(id 必填)
id*integer唯一标识
name?string任务名称
type?CronTaskType任务类型,当前固定分为 user 和 system
值于
"user""system"cron?string定时规则(5位或6位的定时表达式)
shell?string执行的命令
active?BinaryStatus状态,1 启用、0 禁用
值于
01config?string高级配置(值为 JSON 序列化后的字符串,结构见 CronTaskConfig)
tags?string任务标签
last_runtime?|最后一次运行的时间
格式
date-timelast_run_use?|最后一次运行的时长(单位秒,精确到小数点后3位)
sort?integer在分页中的位置序号(正整数),默认按照先后顺序递增
create_time?string任务创建时间
格式
date-timeremark?string备注
bind?string任务关联的内部标识(仅系统任务返回)
error_notify?integer任务执行失败时是否自动推送通知(1=启用,0=禁用)
默认
1is_running?boolean当前运行状态(任务是否正在运行)
返回更新后的任务完整信息
application/json- response
定时任务完整记录(响应数据)
id*integer唯一标识
name*string任务名称
type*CronTaskType任务类型,当前固定分为 user 和 system
值于
"user""system"cron*string定时规则(5位或6位的定时表达式)
shell*string执行的命令
active*BinaryStatus状态,1 启用、0 禁用
值于
01config*string高级配置(值为 JSON 序列化后的字符串,结构见 CronTaskConfig)
tags*string任务标签
last_runtime*|最后一次运行的时间
格式
date-timelast_run_use*|最后一次运行的时长(单位秒,精确到小数点后3位)
sort*integer在分页中的位置序号(正整数),默认按照先后顺序递增
create_time*string任务创建时间
格式
date-timeremark*string备注
bind*string任务关联的内部标识(仅系统任务返回)
error_notify*integer任务执行失败时是否自动推送通知(1=启用,0=禁用)
默认
1is_running*boolean当前运行状态(任务是否正在运行)
error_alert*string运行失败告警关联的通知渠道 ID(逗号分隔),内部业务字段
curl -X POST "https://example.com/cron/v1/update" \ -H "Content-Type: application/json" \ -d '{}'{ "id": 0, "name": "string", "type": "user", "cron": "string", "shell": "string", "active": 0, "config": "string", "tags": "string", "last_runtime": "2019-08-24T14:15:22Z", "last_run_use": 0, "sort": 0, "create_time": "2019-08-24T14:15:22Z", "remark": "string", "bind": "string", "error_notify": 1, "is_running": true, "error_alert": "string"}
