响应示例 返回状态码为200：修改站点DHCP配置结果，返回结构体参见ApDhcpConfigResponsesDto。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : { "ip" : "192.168.1.1", "mask" : "255.255.255.0", "dnsConfig" : { "dnsServerMode" : "systemsetting", "priorDnsServer" : "192.168.1.10", "standbyDnsServer" : "192.168.1.11" }, "tenancyConfig" : { "day" : 999, "hour" : 23, "minute" : 59 }, "masterWins" : "192.168.1.1", "slaveWins" : "192.168.1.2", "ipBindingMacConfigList" : [ { "staticIpAddress" : "192.168.1.10", "staticMacAddress" : "00:00:00:00:00:00" } ], "lanVlanId" : 3911, "dhcpEnable" : true } } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求示例 HTTP的示例 PUT /controller/campus/v3/networkconfig/site/fbde1c5d-5b94-49e3-a912-48641015e45c/apdhcp HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-AC CES S-TOKEN: x-yyyyyy { "ip" : "192.168.1.1", "mask" : "255.255.255.0", "dnsConfig" : { "dnsServerMode" : "systemsetting", "priorDnsServer" : "192.168.1.10", "standbyDnsServer" : "192.168.1.11" }, "tenancyConfig" : { "day" : 999, "hour" : 23, "minute" : 59 }, "masterWins" : "192.168.1.1", "slaveWins" : "192.168.1.2", "ipBindingMacConfigList" : [ { "staticIpAddress" : "192.168.1.10", "staticMacAddress" : "00:00:00:00:00:00" } ], "lanVlanId" : 3911, "dhcpEnable" : true }

请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 apDhcpConfigApiDto 是 REFERENCE 详细请参见表3。 修改站点全局DHCP配置入参，结构体参见ApDhcpConfigApiDto。 - 表3 ApDhcpConfigApiDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 ip 否 string - - 单播IP地址。当dhcpEnable为true或不填时，必填。 "192.168.1.1" mask 否 string 255.255.252.0 255.255.254.0 255.255.255.0 255.255.255.128 255.255.255.192 255.255.255.224 255.255.255.240 255.255.255.248 255.255.255.252 - 子网掩码。当dhcpEnable为true或不填时，必填。 "255.255.255.0" dnsConfig 否 REFERENCE 详细请参见表4。 - - tenancyConfig 否 REFERENCE 详细请参见表5。 租期（不填时，默认值为1天）。 - masterWins 否 string - - 主wins，单播IP地址（主，备wins不能重复）。 "192.168.1.1" slaveWins 否 string - - 备wins，单播IP地址。 "192.168.1.2" ipBindingMacConfigList 否 ARRAY_REFERENCE 0-8个列表项，详细请参见表6。 静态绑定列表，最大8条。IP，MAC都不能重复，结构体参见IpBindingMacConfigApiDto。 - lanVlanId 否 integer [1-4094] - 不能是已配置的业务VLAN，且修改该VLAN会造成NAT、IPSec用户下线。当dhcpEnable为true或不填时，必填。 3911 dhcpEnable 否 boolean true false - dhcp使能开关。取值false时，关闭dhcp功能，其余值不需要填值。不填值或取值true时，打开dhcp功能。 true 表4 DnsConfigApiDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 dnsServerMode 否 string systemsetting custom - DNS服务器模式（systemsetting为“系统DNS配置”；custom为“自定义”）。 "systemsetting" priorDnsServer 否 string - - 主DNS服务器IP地址，不能与备DNS服务器IP重复。不能为广播，组播IP。当dnsServerMode为custom模式时，该参数生效，且必填 "192.168.1.10" standbyDnsServer 否 string - - 备DNS服务器IP地址，不能与主DNS服务器IP重复。不能为广播，组播IP。当dnsServerMode为custom模式时，该参数生效 "192.168.1.11" 表5 TenancyConfigApiDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 day 是 integer [0-999] - 天，取值范围：0-999。day，hour，minute全为0时表示无限。 999 hour 是 integer [0-23] - 小时，取值范围：0-23。 23 minute 是 integer [0-59] - 分钟，取值范围：0-59。 59 表6 IpBindingMacConfigApiDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 staticIpAddress 是 string - - IP地址，不能与列表中其他IP重复。IP为上面网段（IP+mask计算得出）中的可分配IP地址，且不能为网关IP（上面配置IP）。 "192.168.1.10" staticMacAddress 是 string - - MAC地址，不能与列表中其他MAC地址重复。MAC不能为广播（全F），组播（第一段2进制表示以“1”结尾）。 "00:00:00:00:00:00"

响应示例 返回状态码为200：当前站点的全局DHCP配置信息，返回结构体参见ApDhcpConfigResponsesDto。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : { "ip" : "192.168.1.1", "mask" : "255.255.255.0", "dnsConfig" : { "dnsServerMode" : "systemsetting", "priorDnsServer" : "192.168.1.10", "standbyDnsServer" : "192.168.1.11" }, "tenancyConfig" : { "day" : 999, "hour" : 23, "minute" : 59 }, "masterWins" : "192.168.1.1", "slaveWins" : "192.168.1.2", "ipBindingMacConfigList" : [ { "staticIpAddress" : "192.168.1.10", "staticMacAddress" : "00:00:00:00:00:00" } ], "lanVlanId" : 3911, "dhcpEnable" : true } } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求示例 HTTP的示例 GET /controller/campus/v3/networkconfig/site/fbde1c5d-5b94-49e3-a912-48641015e45c/apdhcp HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy

响应参数 返回状态码为200：当前站点的全局DHCP配置信息，返回结构体参见ApDhcpConfigResponsesDto。 表2 ApDhcpConfigResponsesDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" data REFERENCE 详细请参见表3。 - - 表3 ApDhcpConfigApiDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 ip string - - 单播IP地址。当dhcpEnable为true或不填时，必填。 "192.168.1.1" mask string 255.255.252.0 255.255.254.0 255.255.255.0 255.255.255.128 255.255.255.192 255.255.255.224 255.255.255.240 255.255.255.248 255.255.255.252 - 子网掩码。当dhcpEnable为true或不填时，必填。 "255.255.255.0" dnsConfig REFERENCE 详细请参见表4。 - - tenancyConfig REFERENCE 详细请参见表5。 租期（不填时，默认值为1天）。 - masterWins string - - 主wins，单播IP地址（主，备wins不能重复）。 "192.168.1.1" slaveWins string - - 备wins，单播IP地址。 "192.168.1.2" ipBindingMacConfigList ARRAY_REFERENCE 0-8个列表项，详细请参见表6。 静态绑定列表，最大8条。IP，MAC都不能重复，结构体参见IpBindingMacConfigApiDto。 - lanVlanId integer [1-4094] - 不能是已配置的业务VLAN，且修改该VLAN会造成NAT、IPSec用户下线。当dhcpEnable为true或不填时，必填。 3911 dhcpEnable boolean true false - dhcp使能开关。取值false时，关闭dhcp功能，其余值不需要填值。不填值或取值true时，打开dhcp功能。 true 表4 DnsConfigApiDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 dnsServerMode string systemsetting custom - DNS服务器模式（systemsetting为“系统DNS配置”；custom为“自定义”）。 "systemsetting" priorDnsServer string - - 主DNS服务器IP地址，不能与备DNS服务器IP重复。不能为广播，组播IP。当dnsServerMode为custom模式时，该参数生效，且必填 "192.168.1.10" standbyDnsServer string - - 备DNS服务器IP地址，不能与主DNS服务器IP重复。不能为广播，组播IP。当dnsServerMode为custom模式时，该参数生效 "192.168.1.11" 表5 TenancyConfigApiDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 day integer [0-999] - 天，取值范围：0-999。day，hour，minute全为0时表示无限。 999 hour integer [0-23] - 小时，取值范围：0-23。 23 minute integer [0-59] - 分钟，取值范围：0-59。 59 表6 IpBindingMacConfigApiDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 staticIpAddress string - - IP地址，不能与列表中其他IP重复。IP为上面网段（IP+mask计算得出）中的可分配IP地址，且不能为网关IP（上面配置IP）。 "192.168.1.10" staticMacAddress string - - MAC地址，不能与列表中其他MAC地址重复。MAC不能为广播（全F），组播（第一段2进制表示以“1”结尾）。 "00:00:00:00:00:00" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。