接口描述

修改节点的调度配置，如跨省调度，IPv6调度等，小盒子不支持设置期望调度时间。

限速限制：仅非机房设备可进行限速操作；机房节点设备不支持限速。对机房节点设备开启限速时，接口返回错误『机房节点设备不支持限速操作』（HTTP 400，code 406001）。此处『开启限速』指 qosThrottling=true，或 netSchedule.type 为 dayExperience / timeRangeExperience。qosThrottling=false 与 netSchedule.type=dayTraffic 属于关闭/不限速，不受此限制。

请求路径

PUT /v1/ant/<nodeID>/schedule

请求参数

名称	类型	位置	必须	描述
Authorization	string	header	是	鉴权 token
Content-Type	string	header	是	数据类型 application/json
nodeID	string	path	是	节点 ID
isIPv6Schedule	bool	body	否	是否仅ipv6调度，不传默认为否
isTransProv	bool	body	否	是否支持跨省调度，不传默认为否
transProvRate	double	body	否	跨省调度比例，只有isTransProv=true时才生效。（该参数已于2025.4.1失效）
netSchedule	NetSchedule	body	否	网络调度
qosThrottling	bool	body	否	当前是否开启板卡限速，默认为false（机房节点设备不支持，置 true 会被拒绝，code 406001）
isTransISP	bool	body	否	是否开启异网，不跨省时默认为true

NetSchedule

名称	类型	位置	必须	描述
type	string	body	是	网络调度模式 dayTraffic：全天跑量优先 dayExperience：全天体验优先 timeRangeExperience：分时段体验优先 dayExperience / timeRangeExperience 为体验优先（即限速），机房节点设备不支持；dayTraffic（跑量优先）不限速、不受限制
timeRangeExperience	NetScheduleTimeRangeExperience	body	否	分时段体验优先的时间范围，选择分时段体验优先时必传

NetScheduleTimeRangeExperience

名称	类型	位置	必须	描述
timeRanges	[]NetScheduleTimeRange	body	是	时间范围

NetScheduleTimeRange

名称	类型	位置	必须	描述
startElapsedSecs	int	body	是	开始限制时间，距离0点过去的秒数
endElapsedSecs	int	body	是	结束限制时间，距离0点过去的秒数

返回值

无

错误码列表

错误码	描述
401	鉴权失败
4000001	参数有误, 描述中会包含详细信息
4000002	节点未查找到
4000005	节点状态异常
4000009	流程动作非法
406001	机房节点设备不支持限速操作（HTTP 400，对机房节点设备开启限速时触发）

对机房节点设备开启限速时的失败响应示例：

{
  "code": 406001,
  "desc": "机房节点设备不支持限速操作"
}

如接口返回错误码未列举，可在错误码总览中查找