简要描述
修改定时任务
请求 URL
https://openapi.mp.usr.cn/usrCloud/circular/updateScheduledTask
请求方式
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 |
接口调用受到用户等级限制 |
请求示例
- POST https://openapi.mp.usr.cn/usrCloud/circular/updateScheduledTask
- Content-Type: application/json
-
- {
- "id": 391,
- "name": "88888888",
- "projectId": 22827,
- "cronType": 1,
- "recordType": 1,
- "deviceNo": "00000096000000000056",
- "type":0,
- "taskTargets": [
- {
- "slaveIndex": "1",
- "dataId": 33422,
- "sendData": "888",
- "cronWeek": "2",
- "cronHour": "00",
- "cronMinute": "00",
- "startDt": 1583811128959,
- "endDt": 1583811128959,
- "taskType": 1,
- "id": 564
- }
- ],
- }
响应示例
status: 0,info: ok
- Content-Type: application/json
-
- {
- "status": 0,
- "info": "ok",
- "account": "sy200",
- "keyDesp": "修改定时任务【未命名_定时任务_95】"
-
- }