更新调度计划，机机接口，全量更新字段
功能介绍
用户通过北向接口修改边缘节点上调度计划
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
PUT /v2/{project_id}/edge-nodes/{edge_node_id}/schedules/{schedule_id}
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目ID。获取方法请参见 获取项目ID。 |
edge_node_id |
是 |
String |
边缘节点ID 最小长度：1 最大长度：64 |
schedule_id |
是 |
String |
调度计划id 最小长度：1 最大长度：64 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 最小长度：0 最大长度：20000 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
name |
是 |
String |
调度计划名称 最小长度：1 最大长度：64 |
enabled |
是 |
Boolean |
调度计划是否生效 最小长度：1 最大长度：64 |
start_time |
否 |
Long |
调度计划起始时间，毫秒级别的时间戳 最小值：0 最大值：4828176000000 |
end_time |
是 |
Long |
调度计划结束时间，毫秒级别的时间戳 最小值：0 最大值：4828176000000 |
priority |
是 |
Integer |
调度计划优先级。 最小值：1 最大值：16 |
daily |
否 |
DailyDto object |
每天的时间描述结构体 |
tasks |
是 |
Array of ScheduleTask objects |
调度任务信息 数组长度：1 - 10 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
exceptional_dates |
否 |
ExceptionalDates object |
例外的日期，valid_dates表示需要执行的日期，invalid_dates表示不执行的日期。其优先级最高，优先级：ExceptionalDates > weekdays > start_time-endtime |
time_spans |
是 |
Array of TimeSpans objects |
时间段描述 数组长度：1 - 10 |
weekdays |
否 |
Object |
描述此任务有效的星期几，为数组。如果为null，则表示start_time-endtime之间，每天都执行；如果为空数组，则表示start_time-endtime之间，每天都不执行；如果为[1, 2]，则表示每周一、二执行。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
valid_dates |
否 |
Array of strings |
例外日期 数组长度：0 - 100 |
invalid_dates |
否 |
Array of strings |
无效日期 数组长度：0 - 100 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
schedule_id |
String |
调度计划id，租户下唯一 最小长度：1 最大长度：64 |
node_id |
String |
节点id 最小长度：1 最大长度：64 |
name |
String |
调度计划名称 最小长度：1 最大长度：64 |
cycle_type |
String |
调度计划的循环类型 最小长度：1 最大长度：64 |
enabled |
Boolean |
调度计划是否生效 最小长度：1 最大长度：64 |
start_time |
Long |
调度计划起始时间，毫秒级别的时间戳 最小值：0 最大值：4828176000000 |
end_time |
Long |
调度计划结束时间，毫秒级别的时间戳 最小值：0 最大值：4828176000000 |
priority |
Integer |
调度计划优先级, 1-16 最小值：1 最大值：16 |
daily |
DailyDto object |
每天的时间描述结构体 |
tasks |
Array of ScheduleTask objects |
调度任务信息 数组长度：1 - 10 |
参数 |
参数类型 |
描述 |
|---|---|---|
exceptional_dates |
ExceptionalDates object |
例外的日期，valid_dates表示需要执行的日期，invalid_dates表示不执行的日期。其优先级最高，优先级：ExceptionalDates > weekdays > start_time-endtime |
time_spans |
Array of TimeSpans objects |
时间段描述 数组长度：1 - 10 |
weekdays |
Object |
描述此任务有效的星期几，为数组。如果为null，则表示start_time-endtime之间，每天都执行；如果为空数组，则表示start_time-endtime之间，每天都不执行；如果为[1, 2]，则表示每周一、二执行。 |
参数 |
参数类型 |
描述 |
|---|---|---|
valid_dates |
Array of strings |
例外日期 数组长度：0 - 100 |
invalid_dates |
Array of strings |
无效日期 数组长度：0 - 100 |
请求示例
PUT https://{endpoint}/v2/{project_id}/edge-nodes/{edge_node_id}/schedules/{schedule_id}
{
"name" : "H1照明控制",
"enabled" : true,
"start_time" : 1691572410000,
"end_time" : 1691572410000,
"priority" : 9,
"daily" : {
"exceptional_dates" : {
"valid_dates" : [ "2023-01-01" ],
"invalid_dates" : [ "2023-01-02" ]
},
"time_spans" : [ {
"start" : "11:40:00",
"end" : "11:49:00"
} ],
"weekdays" : [ 1, 2, 3 ]
},
"tasks" : [ {
"device_ids" : [ "device1" ],
"action" : "SetProperties",
"paras" : [ {
"service_id" : "dataService",
"properties" : {
"Switch" : 1
}
} ]
} ]
}
响应示例
状态码： 200
OK
{
"schedule_id" : "1A",
"node_id" : "node1",
"name" : "H1照明控制",
"cycle_type" : "daily",
"enabled" : true,
"start_time" : 1691572410000,
"end_time" : 1691572410000,
"priority" : 9,
"daily" : {
"exceptional_dates" : {
"valid_dates" : [ "2023-01-01" ],
"invalid_dates" : [ "2023-01-02" ]
},
"time_spans" : [ {
"start" : "11:40:00",
"end" : "11:49:00"
} ],
"weekdays" : [ 1, 2, 3 ]
},
"tasks" : [ {
"device_ids" : [ "device1" ],
"action" : "SetProperties",
"paras" : [ {
"service_id" : "dataService",
"properties" : {
"Switch" : 1
}
} ]
} ]
}
状态码
状态码 |
描述 |
|---|---|
200 |
OK |
400 |
Bad Request |
404 |
Not Found |
错误码
请参见错误码。
