创建指定交换机的子网配置
典型场景
提供在指定交换机设备上,新增子网配置的接口。
接口功能
新增交换机子网配置。
接口约束
该接口支持租户视图或msp代维视图下,用户角色为“Open Api Operator”的用户访问,必须在用户会话建立后使用。
调用方法
POST
URI
/controller/campus/v1/networkservice/networkconfig/net/lswsubnet/devices/{deviceId}/subnet
参数名称 |
必选 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|---|
deviceId |
是 |
string |
- |
- |
设备ID,UUID格式。 |
"fbb684c8-0d37-496f-bafa-4b06d5151e2e" |
请求参数
参数名称 |
必选 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|---|
body |
是 |
REFERENCE |
详细请参见表3。 |
子网配置的参数体。 |
- |
参数名称 |
必选 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|---|
name |
是 |
string |
1~32个字符。 |
- |
子网名称。1-32位英文字母、数字或特殊符号(特殊符号不包括问号“?” 和空格“ ”)。在同一交换机上,子网的name不能相同。 |
"subnet1" |
vlanId |
是 |
integer |
[1-4094] |
- |
VLAN ID。1-4094之间的整数,建议VLAN ID不要配置和管理VLAN 相同,否则可能会导致设备脱管。在同一交换机上,子网的vlanId不能相同。vlanId不支持修改。 |
100 |
ipv4poolOrNot |
是 |
integer |
[0-0] |
- |
IP获取方式。0:手动。 |
0 |
ipAddress |
否 |
string |
0~15个字符。 |
- |
子网IP地址。必须是合法的单播IPV4地址,不允许是子网网段或0.0.0.0。当ipv4poolOrNot为0时,ipAddress必填。在同一交换机上,子网网段不能重叠。 |
"192.168.12.12" |
maskAddress |
否 |
integer |
[1-30] |
- |
子网掩码。当dhcpConfig.dhcpMode为server时,maskAddress要大于15。当ipv4poolOrNot为0时,maskAddress必填。 |
24 |
subIpList |
否 |
ARRAY_REFERENCE |
0-31个列表项,详细请参见表4。 |
子项IP列表,不能重复。 |
- |
|
arpEnable |
否 |
boolean |
|
false |
ARP代理开关使能。 |
false |
mtu |
是 |
integer |
[128-9216] |
1500 |
MTU(接口的最大传输单元),取值为128-9216之间的整数。 |
1500 |
dhcpEnable |
是 |
boolean |
|
true |
DHCP开关使能,当dhcpEnable为true时,dhcpConfig必填。 |
true |
icmpRedirectSendEnable |
否 |
boolean |
|
true |
ICMP报文转发使能,默认为true。 |
true |
dhcpConfig |
否 |
REFERENCE |
详细请参见表5。 |
- |
- |
参数名称 |
必选 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|---|
subIpAddress |
是 |
string |
0~15个字符。 |
- |
子项IP地址,必须是合法的IPV4地址,子项IP不能与ipAddress相同。 |
"192.168.13.13" |
subMaskAddress |
是 |
integer |
[1-30] |
- |
子项IP掩码。 |
24 |
参数名称 |
必选 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|---|
dhcpMode |
是 |
string |
|
- |
DHCP模式。relay:中继, server:服务器。当dhcpMode取值为server时,dhcpServerConfig必填,当dhcpMode取值为relay时,relayServerIps必填。 |
"server" |
relayServerIps |
否 |
array<string> |
0-8 个列表项。 |
- |
DHCP服务器IP列表,最多为8个单播IPV4地址,不能重复。当dhcpMode取值为relay时,relayServerIps必填。 |
["10.122.12.1"] |
dhcpServerConfig |
否 |
REFERENCE |
详细请参见表6。 |
- |
- |
参数名称 |
必选 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|---|
dnsConfig |
是 |
REFERENCE |
详细请参见表7。 |
- |
- |
|
domainSuffix |
否 |
string |
1~63个字符。 |
- |
域名后缀,只能包含字母、数字、下划线“_”或点“.”。 |
"com" |
manegeNetworkEnable |
是 |
boolean |
|
true |
管理网络使能开关。当manegeNetworkEnable为false时,exceptFitAp配置不生效,option148不允许为true,fixIpEnable不允许为true。 |
true |
exceptFitAp |
否 |
string |
|
- |
AP模式。当manegeNetworkEnable为true时,exceptFitAp必填。 |
"CloudAP" |
option148 |
否 |
boolean |
|
false |
自动协商控制器地址开关使能。当option148为true时,当前子网的DHCP Server自动生成Option148,子网内的设备(交换机或云AP)可以通过Option148获取控制器地址,完成注册。当option148为true时,占用一条dhcpServerOptions的列表条数,并且dhcpServerOptions[*].code不能填148。 |
false |
acAddressType |
否 |
string |
|
- |
控制器地址类型。当acAddressType为DOMAIN时,请保证现网已配置DNS能对控制器域名进行解析,否则设备将无法向控制器发起注册。当option148为true时,acAddressType必填。 |
"IP" |
option43 |
否 |
boolean |
|
false |
自动协商WAC地址开关使能。当option43为true时,当前子网的DHCP Server自动生成Option43,Fit AP可以通过Option43获取WAC的地址,完成注册。当exceptFitAp为FitAP时,option43为选填。当option43为true时,占用一条dhcpServerOptions的列表条数,并且dhcpServerOptions[*].code不能填43。 |
false |
wacAddress |
否 |
array<string> |
0-2 个列表项。 |
- |
WAC地址列表。当option43为true时,wacAddress必填。 |
["10.122.12.1"] |
dhcpServerLogging |
否 |
boolean |
|
false |
DHCP服务日志记录开关使能。 |
false |
dhcpServerOptions |
否 |
ARRAY_REFERENCE |
0-8个列表项,详细请参见表8。 |
DHCP选项列表。 |
- |
|
leasesConfig |
是 |
REFERENCE |
详细请参见表9。 |
- |
- |
|
excludedAddresses |
否 |
ARRAY_REFERENCE |
0-2个列表项,详细请参见表10。 |
保留IP网段,保留IP网段之间不能重复,且保留IP地址必须在子网IP网段内但不能包含子网的IP地址。 |
- |
|
fixIpEnable |
否 |
boolean |
|
false |
交换机管理地址固化使能开关。当网关设备fixIpEnable为true时,下游交换机上线时,若其管理IP地址在网关设备子网的网段内,控制器会为其自动分配一个固化地址池内的IP地址作为新的静态管理IP地址,用于自动生成静态管理vlan并下发,以避免管理IP地址动态变化。当fixIpEnable为true时,fixedIpRange必填。 |
false |
fixedIpRange |
否 |
ARRAY_REFERENCE |
0-2个列表项,详细请参见表10。 |
固化IP地址网段,固化IP地址网段之间不能重复,固化IP地址与保留IP地址不能重复,且固化IP地址必须在子网IP网段内但不能包含子网的IP地址。 |
- |
|
staticBindings |
否 |
ARRAY_REFERENCE |
0-500个列表项,详细请参见表11。 |
静态地址绑定的IP地址,必须在子网IP网段内,不能在保留IP网段和固化IP地址网段内,不能重复。如果静态绑定的IP/MAC已使用过,请先删除原有的绑定关系并保存,再进行新配置。 |
- |
参数名称 |
必选 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|---|
dnsServerMode |
是 |
string |
|
- |
DNS服务模式,custom:自定义,systemsetting:系统DNS设置。 |
"custom" |
priorDnsServer |
否 |
string |
1~15个字符。 |
- |
首选DNS,必须是合法的单播IPV4地址。当dnsServerMode为custom时,priorDnsServer必填。 |
"10.15.15.15" |
standbyDnsServer |
否 |
string |
1~15个字符。 |
- |
备选DNS,必须是合法的单播IPV4地址,不能和首选DNS priorDnsServer相同。当dnsServerMode为custom时,standbyDnsServer选填。 |
"10.15.15.16" |
参数名称 |
必选 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|---|
code |
是 |
integer |
[1-254] |
- |
DHCP选项代码,取值范围是1-254,但1、3、6、15、44、46、50、51、52、53、54、55、57、58、59、61、82、120、121、184不能配置。 DHCP选项代码和代表选项如下: 26:Interface MTU 2:Time offset 42:NTP server 66:TFTP server name 148:云平台地址 |
26 |
subCode |
否 |
integer |
[1-254] |
- |
DHCP子项代码。code相同时,subCode必填并且唯一。 |
5 |
optionType |
是 |
string |
|
- |
DHCP选项类型,当code取值为26或2时,optionType只能填hex;当code取值为42时,optionType只能填ip-address;当code取值为66或148时,optionType只能填text。 text:文本 hex:Hex ip-address:IP |
"hex" |
optionValue |
是 |
string |
1~255个字符。 |
- |
DHCP选项值,取值说明如下: 当optionType取值是ip-address时,optionValue取值要求:合法的单播IPV4地址; 当code取值为26时,optionValue取值要求:2e-0640之间的十六进制数,且长度只能为偶数,不能以00开头; 当code取值不为26并且optionType为hex时,如果不填subCode,optionValue取值要求:长度为2-254位的十六进制字符串,且长度只能为偶数,不能以00开头;如果填subCode,optionValue取值要求:长度为2-252位的十六进制字符串,且长度只能为偶数,不能以00开头。 当optionType取值是text时,如果不填subCode,optionValue取值要求:长度为1-255位的字符串;如果填subCode,optionValue取值要求:长度为1-253位的字符串。 当code取值为148时,取值示例如下: "agilemode=agile-cloud;agilemanage-mode=domain;agilemanage-domain=device-naas.huawei.com;agilemanage-port=10020;" 建议取值说明如下: agilemode:值为agile-cloud(云平台默认下发模式)、tradition(通过外挂的DHCP server option148切换)或者tradition-fit(WAC场景下的fit模式切换;只有AP识别此种类型)。 agilemanage-mode:值为ip或者domain,表示agilemanage-domain的参数值是IP地址还是域名。 agilemanage-domain:云平台的域名或者IP地址。 agilemanage-port:格式为数字,表示云平台的端口。 |
"2e" |
参数名称 |
必选 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|---|
unlimit |
是 |
boolean |
|
false |
租期是否无限期。当unlimit为true时,表示租期为无限期,day、hour、minute只能为0。 |
false |
day |
是 |
integer |
[0-999] |
1 |
租期时间:天。 |
1 |
hour |
是 |
integer |
[0-23] |
0 |
租期时间:时。 |
0 |
minute |
是 |
integer |
[0-59] |
0 |
租期时间:分。 |
0 |
请求示例
POST /controller/campus/v1/networkservice/networkconfig/net/lswsubnet/devices/fbb684c8-0d37-496f-bafa-4b06d5151e2e/subnet 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 { "name" : "subnet1", "vlanId" : 100, "ipv4poolOrNot" : 0, "ipAddress" : "192.168.12.12", "maskAddress" : 24, "subIpList" : [ { "subIpAddress" : "192.168.13.13", "subMaskAddress" : 24 } ], "arpEnable" : false, "mtu" : 1500, "dhcpEnable" : true, "icmpRedirectSendEnable" : true, "dhcpConfig" : { "dhcpMode" : "server", "relayServerIps" : [ "10.122.12.1" ], "dhcpServerConfig" : { "dnsConfig" : { "dnsServerMode" : "custom", "priorDnsServer" : "10.15.15.15", "standbyDnsServer" : "10.15.15.16" }, "domainSuffix" : "com", "manegeNetworkEnable" : true, "exceptFitAp" : "CloudAP", "option148" : false, "acAddressType" : "IP", "option43" : false, "wacAddress" : [ "10.122.12.1" ], "dhcpServerLogging" : false, "dhcpServerOptions" : [ { "code" : 26, "subCode" : 5, "optionType" : "hex", "optionValue" : "2e" } ], "leasesConfig" : { "unlimit" : false, "day" : 1, "hour" : 0, "minute" : 0 }, "excludedAddresses" : [ { "startIpAddress" : "192.168.12.13", "endIpAddress" : "192.168.12.13" } ], "fixIpEnable" : false, "fixedIpRange" : [ { "startIpAddress" : "192.168.12.13", "endIpAddress" : "192.168.12.13" } ], "staticBindings" : [ { "staticIpAddress" : "192.168.12.14", "staticMacAddress" : "XX:XX:XX:XX:XX:XX" } ] } } }
响应参数
返回状态码为200:新增交换机子网成功。
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
errcode |
string |
0~64个字符。 |
- |
错误码。 |
"0" |
errmsg |
string |
0~256个字符。 |
- |
错误信息。 |
"" |
data |
REFERENCE |
详细请参见表13。 |
- |
- |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
name |
string |
1~32个字符。 |
- |
子网名称。1-32位英文字母、数字或特殊符号(特殊符号不包括问号“?” 和空格“ ”)。在同一交换机上,子网的name不能相同。 |
"subnet1" |
vlanId |
integer |
[1-4094] |
- |
VLAN ID。1-4094之间的整数,建议VLAN ID不要配置和管理VLAN 相同,否则可能会导致设备脱管。在同一交换机上,子网的vlanId不能相同。vlanId不支持修改。 |
100 |
ipv4poolOrNot |
integer |
[0-0] |
- |
IP获取方式。0:手动。 |
0 |
ipAddress |
string |
0~15个字符。 |
- |
子网IP地址。必须是合法的单播IPV4地址,不允许是子网网段或0.0.0.0。当ipv4poolOrNot为0时,ipAddress必填。在同一交换机上,子网网段不能重叠。 |
"192.168.12.12" |
maskAddress |
integer |
[1-30] |
- |
子网掩码。当dhcpConfig.dhcpMode为server时,maskAddress要大于15。当ipv4poolOrNot为0时,maskAddress必填。 |
24 |
subIpList |
ARRAY_REFERENCE |
0-31个列表项,详细请参见表14。 |
子项IP列表,不能重复。 |
- |
|
arpEnable |
boolean |
|
false |
ARP代理开关使能。 |
false |
mtu |
integer |
[128-9216] |
1500 |
MTU(接口的最大传输单元),取值为128-9216之间的整数。 |
1500 |
dhcpEnable |
boolean |
|
true |
DHCP开关使能,当dhcpEnable为true时,dhcpConfig必填。 |
true |
icmpRedirectSendEnable |
boolean |
|
true |
ICMP报文转发使能,默认为true。 |
true |
dhcpConfig |
REFERENCE |
详细请参见表15。 |
- |
- |
|
id |
string |
32个字符。 |
- |
子网ID。 |
"30a51c112787470f81045d60ccf3995f" |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
subIpAddress |
string |
0~15个字符。 |
- |
子项IP地址,必须是合法的IPV4地址,子项IP不能与ipAddress相同。 |
"192.168.13.13" |
subMaskAddress |
integer |
[1-30] |
- |
子项IP掩码。 |
24 |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
dhcpMode |
string |
|
- |
DHCP模式。relay:中继, server:服务器。当dhcpMode取值为server时,dhcpServerConfig必填,当dhcpMode取值为relay时,relayServerIps必填。 |
"server" |
relayServerIps |
array<string> |
0-8 个列表项。 |
- |
DHCP服务器IP列表,最多为8个单播IPV4地址,不能重复。当dhcpMode取值为relay时,relayServerIps必填。 |
["10.122.12.1"] |
dhcpServerConfig |
REFERENCE |
详细请参见表16。 |
- |
- |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
dnsConfig |
REFERENCE |
详细请参见表17。 |
- |
- |
|
domainSuffix |
string |
1~63个字符。 |
- |
域名后缀,只能包含字母、数字、下划线“_”或点“.”。 |
"com" |
manegeNetworkEnable |
boolean |
|
true |
管理网络使能开关。当manegeNetworkEnable为false时,exceptFitAp配置不生效,option148不允许为true,fixIpEnable不允许为true。 |
true |
exceptFitAp |
string |
|
- |
AP模式。当manegeNetworkEnable为true时,exceptFitAp必填。 |
"CloudAP" |
option148 |
boolean |
|
false |
自动协商控制器地址开关使能。当option148为true时,当前子网的DHCP Server自动生成Option148,子网内的设备(交换机或云AP)可以通过Option148获取控制器地址,完成注册。当option148为true时,占用一条dhcpServerOptions的列表条数,并且dhcpServerOptions[*].code不能填148。 |
false |
acAddressType |
string |
|
- |
控制器地址类型。当acAddressType为DOMAIN时,请保证现网已配置DNS能对控制器域名进行解析,否则设备将无法向控制器发起注册。当option148为true时,acAddressType必填。 |
"IP" |
option43 |
boolean |
|
false |
自动协商WAC地址开关使能。当option43为true时,当前子网的DHCP Server自动生成Option43,Fit AP可以通过Option43获取WAC的地址,完成注册。当exceptFitAp为FitAP时,option43为选填。当option43为true时,占用一条dhcpServerOptions的列表条数,并且dhcpServerOptions[*].code不能填43。 |
false |
wacAddress |
array<string> |
0-2 个列表项。 |
- |
WAC地址列表。当option43为true时,wacAddress必填。 |
["10.122.12.1"] |
dhcpServerLogging |
boolean |
|
false |
DHCP服务日志记录开关使能。 |
false |
dhcpServerOptions |
ARRAY_REFERENCE |
0-8个列表项,详细请参见表18。 |
DHCP选项列表。 |
- |
|
leasesConfig |
REFERENCE |
详细请参见表19。 |
- |
- |
|
excludedAddresses |
ARRAY_REFERENCE |
0-2个列表项,详细请参见表20。 |
保留IP网段,保留IP网段之间不能重复,且保留IP地址必须在子网IP网段内但不能包含子网的IP地址。 |
- |
|
fixIpEnable |
boolean |
|
false |
交换机管理地址固化使能开关。当网关设备fixIpEnable为true时,下游交换机上线时,若其管理IP地址在网关设备子网的网段内,控制器会为其自动分配一个固化地址池内的IP地址作为新的静态管理IP地址,用于自动生成静态管理vlan并下发,以避免管理IP地址动态变化。当fixIpEnable为true时,fixedIpRange必填。 |
false |
fixedIpRange |
ARRAY_REFERENCE |
0-2个列表项,详细请参见表20。 |
固化IP地址网段,固化IP地址网段之间不能重复,固化IP地址与保留IP地址不能重复,且固化IP地址必须在子网IP网段内但不能包含子网的IP地址。 |
- |
|
staticBindings |
ARRAY_REFERENCE |
0-500个列表项,详细请参见表21。 |
静态地址绑定的IP地址,必须在子网IP网段内,不能在保留IP网段和固化IP地址网段内,不能重复。如果静态绑定的IP/MAC已使用过,请先删除原有的绑定关系并保存,再进行新配置。 |
- |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
dnsServerMode |
string |
|
- |
DNS服务模式,custom:自定义,systemsetting:系统DNS设置。 |
"custom" |
priorDnsServer |
string |
1~15个字符。 |
- |
首选DNS,必须是合法的单播IPV4地址。当dnsServerMode为custom时,priorDnsServer必填。 |
"10.15.15.15" |
standbyDnsServer |
string |
1~15个字符。 |
- |
备选DNS,必须是合法的单播IPV4地址,不能和首选DNS priorDnsServer相同。当dnsServerMode为custom时,standbyDnsServer选填。 |
"10.15.15.16" |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
code |
integer |
[1-254] |
- |
DHCP选项代码,取值范围是1-254,但1、3、6、15、44、46、50、51、52、53、54、55、57、58、59、61、82、120、121、184不能配置。 DHCP选项代码和代表选项如下: 26:Interface MTU 2:Time offset 42:NTP server 66:TFTP server name 148:云平台地址 |
26 |
subCode |
integer |
[1-254] |
- |
DHCP子项代码。code相同时,subCode必填并且唯一。 |
5 |
optionType |
string |
|
- |
DHCP选项类型,当code取值为26或2时,optionType只能填hex;当code取值为42时,optionType只能填ip-address;当code取值为66或148时,optionType只能填text。 text:文本 hex:Hex ip-address:IP |
"hex" |
optionValue |
string |
1~255个字符。 |
- |
DHCP选项值,取值说明如下: 当optionType取值是ip-address时,optionValue取值要求:合法的单播IPV4地址; 当code取值为26时,optionValue取值要求:2e-0640之间的十六进制数,且长度只能为偶数,不能以00开头; 当code取值不为26并且optionType为hex时,如果不填subCode,optionValue取值要求:长度为2-254位的十六进制字符串,且长度只能为偶数,不能以00开头;如果填subCode,optionValue取值要求:长度为2-252位的十六进制字符串,且长度只能为偶数,不能以00开头。 当optionType取值是text时,如果不填subCode,optionValue取值要求:长度为1-255位的字符串;如果填subCode,optionValue取值要求:长度为1-253位的字符串。 当code取值为148时,取值示例如下: "agilemode=agile-cloud;agilemanage-mode=domain;agilemanage-domain=device-naas.huawei.com;agilemanage-port=10020;" 建议取值说明如下: agilemode:值为agile-cloud(云平台默认下发模式)、tradition(通过外挂的DHCP server option148切换)或者tradition-fit(WAC场景下的fit模式切换;只有AP识别此种类型)。 agilemanage-mode:值为ip或者domain,表示agilemanage-domain的参数值是IP地址还是域名。 agilemanage-domain:云平台的域名或者IP地址。 agilemanage-port:格式为数字,表示云平台的端口。 |
"2e" |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
unlimit |
boolean |
|
false |
租期是否无限期。当unlimit为true时,表示租期为无限期,day、hour、minute只能为0。 |
false |
day |
integer |
[0-999] |
1 |
租期时间:天。 |
1 |
hour |
integer |
[0-23] |
0 |
租期时间:时。 |
0 |
minute |
integer |
[0-59] |
0 |
租期时间:分。 |
0 |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
startIpAddress |
string |
1~15个字符。 |
- |
IP网段的起始IP地址,必须在子网IP网段内但不能包含子网的IP地址。 |
"192.168.12.13" |
endIpAddress |
string |
1~15个字符。 |
- |
IP网段的结束IP地址,必须在子网IP网段内但不能包含子网的IP地址。 |
"192.168.12.13" |
参数名称 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|
staticIpAddress |
string |
1~15个字符。 |
- |
静态地址绑定的IP地址,必须在子网IP网段内但不能在保留IP网段内,不能重复。 |
"192.168.12.14" |
staticMacAddress |
string |
1~17个字符。 |
- |
静态地址绑定的MAC地址,格式:XX:XX:XX:XX:XX:XX。不能是00:00:00:00:00:00、广播地址和组播地址,不能重复。 |
"XX:XX:XX:XX:XX:XX" |
返回状态码为400:校验异常。
详细信息请参见实际响应消息体。
响应示例
返回状态码为200:新增交换机子网成功。
HTTP/1.1 200 OK Date: Sun,16 Feb 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" : { "name" : "subnet1", "vlanId" : 100, "ipv4poolOrNot" : 0, "ipAddress" : "192.168.12.12", "maskAddress" : 24, "subIpList" : [ { "subIpAddress" : "192.168.13.13", "subMaskAddress" : 24 } ], "arpEnable" : false, "mtu" : 1500, "dhcpEnable" : true, "icmpRedirectSendEnable" : true, "dhcpConfig" : { "dhcpMode" : "server", "relayServerIps" : [ "10.122.12.1" ], "dhcpServerConfig" : { "dnsConfig" : { "dnsServerMode" : "custom", "priorDnsServer" : "10.15.15.15", "standbyDnsServer" : "10.15.15.16" }, "domainSuffix" : "com", "manegeNetworkEnable" : true, "exceptFitAp" : "CloudAP", "option148" : false, "acAddressType" : "IP", "option43" : false, "wacAddress" : [ "10.122.12.1" ], "dhcpServerLogging" : false, "dhcpServerOptions" : [ { "code" : 26, "subCode" : 5, "optionType" : "hex", "optionValue" : "2e" } ], "leasesConfig" : { "unlimit" : false, "day" : 1, "hour" : 0, "minute" : 0 }, "excludedAddresses" : [ { "startIpAddress" : "192.168.12.13", "endIpAddress" : "192.168.12.13" } ], "fixIpEnable" : false, "fixedIpRange" : [ { "startIpAddress" : "192.168.12.13", "endIpAddress" : "192.168.12.13" } ], "staticBindings" : [ { "staticIpAddress" : "192.168.12.14", "staticMacAddress" : "XX:XX:XX:XX:XX:XX" } ] } }, "id" : "30a51c112787470f81045d60ccf3995f" } }
返回状态码为400:校验异常。
HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive