header_logo
header_logo

修改定时任务

简要描述

  1. 修改定时任务

请求 URL

  1. https://openapi.mp.usr.cn/usrCloud/circular/updateScheduledTask

请求方式

  1. POST

用户等级

基础版 企业版 旗舰版

请求参数

名称 必选/可选 类型 位置 说明
X-Access-Token 必选 String Header 登录成功时返回的登录凭证(注意:X-Access-Token 有效时间为2小时,两小时内可以重复使用,获取详情
Content-Type 必选 String Header 消息体的媒体类型,默认取值为”application/json”
id 必选 Integer Body 定时任务自增id
name 必选 String Body 定时任务名称
projectId 可选 Integer Body 组织id
cronType 可选 Integer Body 定时任务执行的类型(0:执行一次 1:重复执行 2:按时间间隔循环执行)
deviceNo 必选 String Body 设备编号
type 必选 String Body 定时任务类型 0:设备类型
recordType 必选 Integer Body 类型
taskTargets 必选 Array Body 任务指向的目标列表

请求数据(taskTargets)

名称 必选/可选 类型 说明
id 必选 Integer 变量定时任务自增id
slaveIndex 必选 String 任务指向从机序号
dataId 必选 Integer 任务指向数据点id
sendData 必选 String 任务执行数据
cronWeek 必选 String 计划时间的CRON-周 cronType为1时必填
cronHour 必选 String 计划时间的CRON-时 cronType为1时必填
cronMinute 必选 String 计划时间的CRON-分 cronType为1,2时必填
startDt 必选 String 开始日期 cronType为0,2时必填
endDt 必选 String 结束日期 cronType为2时必填
taskType 必选 Integer 定时任务的类型(1:向数据点发送)

响应参数

名称 类型 说明
info String 提示消息
status Integer 返回码
account String 用户名
keyDesp Integer 响应内容描述

返回码说明

返回码 说明
0 成功
5106 参数不完整
11000 cron表达式相关参数不正确
11002 定时任务名称已经存在
1600 添加失败
11004 定时任务不存在
2014 设备没有发现
11022 定时任务已经不存在
11008 定时任务启动失败
6004 数据点没有发现
11016 发送数据太长了
11018 重复的定时任务
1762 接口调用受到用户等级限制

请求示例

  1. POST https://openapi.mp.usr.cn/usrCloud/circular/updateScheduledTask
  2. Content-Type: application/json
  3.  
  4. {
  5. "id": 391,
  6. "name": "88888888",
  7. "projectId": 22827,
  8. "cronType": 1,
  9. "recordType": 1,
  10. "deviceNo": "00000096000000000056",
  11. "type":0,
  12. "taskTargets": [
  13. {
  14. "slaveIndex": "1",
  15. "dataId": 33422,
  16. "sendData": "888",
  17. "cronWeek": "2",
  18. "cronHour": "00",
  19. "cronMinute": "00",
  20. "startDt": 1583811128959,
  21. "endDt": 1583811128959,
  22. "taskType": 1,
  23. "id": 564
  24. }
  25. ],
  26. }

响应示例

status: 0,info: ok

  1. Content-Type: application/json
  2.  
  3. {
  4. "status": 0,
  5. "info": "ok",
  6. "account": "sy200",
  7. "keyDesp": "修改定时任务【未命名_定时任务_95】"
  8.  
  9. }
方案咨询
联系方式