-
请求示例 HTTP的示例 GET /controller/campus/v1/sdwan/overlay-network/ip-subnets?pageIndex=0&pageSize=20&sort=interfaceName&vpnId=a99f794e-b510-438c-a75d-de59f02347eb&siteId=a99f794e-b510-438c-a75d-de59f02347eb&id=a99f794e-b510-438c-a75d-de59f02347eb&deviceId=a99f794e-b510-438c-a75d-de59f02347eb&keyWord=20 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
-
响应示例 返回状态码为200:接口调用成功,响应体参考QueryIPSubnetResponse。 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" : "",
"totalRecords" : 200,
"pageSize" : 20,
"pageIndex" : 1,
"data" : [
{
"vpnId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"siteId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"id" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"interfaceType" : "interface",
"interfaceName" : "vlanif20",
"portLagFlag" : false,
"portId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"vlanId" : 1,
"subInterfaceName" : "GE0/0/0.1",
"trustEnable" : false,
"trust" : "dscp",
"ipAddress" : "192.168.1.1",
"prefixLength" : 24,
"secondaryIP" : ["10.10.10.2/24","10.10.11.2/24"],
"siteName" : "site",
"deviceName" : "device",
"vrrp" : {
"enable" : true,
"vrrpId" : 1,
"virtualIpAddress" : "10.1.1.1;10.1.2.1",
"defaultRole" : "master",
"preemptDelay" : 0,
"priority" : 1,
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
],
"vrrpList" : [
{
"vrrpId" : 1,
"virtualIpAddress" : "10.1.1.1;10.1.2.1",
"defaultRole" : "master",
"preemptDelay" : 0,
"priority" : 1,
"authMode" : 0,
"authKey" : "",
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
]
}
]
},
"dhcp" : {
"enable" : false,
"dhcpServiceType" : "server",
"dhcpServer" : {
"excludeIpGroups" : [
{
"startAddress" : "192.168.1.2",
"endAddress" : "192.168.1.3"
}
],
"leaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"voiceOption" : {
"asIp" : "192.168.1.10",
"ncpIp" : "192.168.1.10",
"voiceVlan" : 3,
"failOver" : {
"ipAddress" : "192.168.1.10",
"dialerString" : "12345678"
},
"description" : "description"
},
"dhcpOption" : [
{
"code" : 44,
"type" : "ascii",
"description" : "Wins/Netbios server",
"value" : "192.168.1.1"
}
],
"dhcpStatic" : [
{
"ipAddress" : "192.168.1.10",
"macAddress" : "xxxx-xxxx-xxxx"
}
],
"dns" : ["8.8.8.8","114.114.114.114"],
"domainName" : "example.com",
"useSecondaryIP" : false
},
"dhcpRelay" : {
"serverIps" : ["192.168.1.1"],
"sourceAddress" : "10.10.10.2",
"gatewayAddress" : "10.10.10.3",
"dhcpRelayOption82" : {
"function" : 0,
"vlanId" : 1,
"subOption" : [
{
"subOptionCode" : 0,
"isUserDefined" : true,
"value" : "\"ZID023301\""
}
]
},
"linkSelectionEnable" : true,
"linkSelectionAddress" : "10.10.10.1"
}
},
"securityZone" : "trust",
"proxyArp" : false,
"innerProxyArp" : false,
"attributes" : {
"mtu" : 1500,
"TCPmss" : 1200
},
"description" : "description",
"toVasEnable" : false,
"enableIpv4" : true,
"enableIpv6" : false,
"ipv6Info" : {
"ipv6Address" : "fc00:3::1",
"ipv6PrefixLength" : 64,
"dhcpV6Enable" : true,
"dhcpV6" : {
"dhcpv6ServiceType" : "server",
"dhcpv6Server" : {
"addressPrefix" : "fc00:3::/64",
"addressPrefixLeaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"delegationPrefix" : "fc00:3::/64",
"delegationPrefixAssignLength" : 64,
"delegationPrefixLeaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"excludeIpGroups" : [
{
"startAddress" : "fc00:1::1",
"endAddress" : "fc00:1::10"
}
],
"firstDnsServer" : "fc00:3::1",
"secondDnsServer" : "fc00:3::2",
"domainName" : "0"
},
"dhcpv6Relay" : {
"serverIps" : ["fc00::1"]
}
},
"vrrp6Enable" : true,
"vrrp6" : {
"vrrp6Id" : 1,
"virtualIpv6AddressLinkLocal" : "fe80::7",
"virtualIpv6Address" : "fc00:3::10;fc00:3::11",
"preemptDelay" : 0,
"priority" : 1,
"trackEnable" : true,
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
],
"vrrp6Role" : ""
},
"ipv6NtpDisable" : false,
"raHaltEnable" : false,
"managedAddressFlagEnable" : false
},
"configSource" : "Wan",
"ntpDisable" : false,
"unrHostRouteAdvertiseEnable" : false,
"dhcpTriggerEnable" : false,
"unrRoutesLimitEnable" : false,
"unrRoutesLimit" : 24
}
]
} 返回状态码为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
返回状态码为500:内部错误。 HTTP/1.1 500 Internal Server Error
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
-
响应参数 返回状态码为200:接口调用成功,响应体参考QueryIPSubnetResponse。 表2 QueryIPSubnetResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" totalRecords int32 - - 总的数据条数。 200 pageSize int32 - - 每页显示数量。 20 pageIndex int32 - - 当前页数。 1 data ARRAY_REFERENCE 0-1000个列表项,详细请参见表27。 IP Subnet信息。 - 返回状态码为400:校验异常。 详细信息请参见实际响应消息体。 返回状态码为500:内部错误。 详细信息请参见实际响应消息体。
-
响应示例 返回状态码为200:接口调用成功,响应体参考IPSubnetResponse,返回的IP Subnet信息中仅包含对应的ID。 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" : "",
"success" : [
{
"vpnId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"siteId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"id" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"interfaceType" : "interface",
"interfaceName" : "vlanif20",
"portLagFlag" : false,
"portId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"vlanId" : 1,
"subInterfaceName" : "GE0/0/0.1",
"trustEnable" : false,
"trust" : "dscp",
"ipAddress" : "192.168.1.1",
"prefixLength" : 24,
"secondaryIP" : ["10.10.10.2/24","10.10.11.2/24"],
"siteName" : "site",
"deviceName" : "device",
"vrrp" : {
"enable" : true,
"vrrpId" : 1,
"virtualIpAddress" : "10.1.1.1;10.1.2.1",
"defaultRole" : "master",
"preemptDelay" : 0,
"priority" : 1,
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
],
"vrrpList" : [
{
"vrrpId" : 1,
"virtualIpAddress" : "10.1.1.1;10.1.2.1",
"defaultRole" : "master",
"preemptDelay" : 0,
"priority" : 1,
"authMode" : 0,
"authKey" : "",
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
]
}
]
},
"dhcp" : {
"enable" : false,
"dhcpServiceType" : "server",
"dhcpServer" : {
"excludeIpGroups" : [
{
"startAddress" : "192.168.1.2",
"endAddress" : "192.168.1.3"
}
],
"leaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"voiceOption" : {
"asIp" : "192.168.1.10",
"ncpIp" : "192.168.1.10",
"voiceVlan" : 3,
"failOver" : {
"ipAddress" : "192.168.1.10",
"dialerString" : "12345678"
},
"description" : "description"
},
"dhcpOption" : [
{
"code" : 44,
"type" : "ascii",
"description" : "Wins/Netbios server",
"value" : "192.168.1.1"
}
],
"dhcpStatic" : [
{
"ipAddress" : "192.168.1.10",
"macAddress" : "xxxx-xxxx-xxxx"
}
],
"dns" : ["8.8.8.8","114.114.114.114"],
"domainName" : "example.com",
"useSecondaryIP" : false
},
"dhcpRelay" : {
"serverIps" : ["192.168.1.1"],
"sourceAddress" : "10.10.10.2",
"gatewayAddress" : "10.10.10.3",
"dhcpRelayOption82" : {
"function" : 0,
"vlanId" : 1,
"subOption" : [
{
"subOptionCode" : 0,
"isUserDefined" : true,
"value" : "\"ZID023301\""
}
]
},
"linkSelectionEnable" : true,
"linkSelectionAddress" : "10.10.10.1"
}
},
"securityZone" : "trust",
"proxyArp" : false,
"innerProxyArp" : false,
"attributes" : {
"mtu" : 1500,
"TCPmss" : 1200
},
"description" : "description",
"toVasEnable" : false,
"enableIpv4" : true,
"enableIpv6" : false,
"ipv6Info" : {
"ipv6Address" : "fc00:3::1",
"ipv6PrefixLength" : 64,
"dhcpV6Enable" : true,
"dhcpV6" : {
"dhcpv6ServiceType" : "server",
"dhcpv6Server" : {
"addressPrefix" : "fc00:3::/64",
"addressPrefixLeaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"delegationPrefix" : "fc00:3::/64",
"delegationPrefixAssignLength" : 64,
"delegationPrefixLeaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"excludeIpGroups" : [
{
"startAddress" : "fc00:1::1",
"endAddress" : "fc00:1::10"
}
],
"firstDnsServer" : "fc00:3::1",
"secondDnsServer" : "fc00:3::2",
"domainName" : "0"
},
"dhcpv6Relay" : {
"serverIps" : ["fc00::1"]
}
},
"vrrp6Enable" : true,
"vrrp6" : {
"vrrp6Id" : 1,
"virtualIpv6AddressLinkLocal" : "fe80::7",
"virtualIpv6Address" : "fc00:3::10;fc00:3::11",
"preemptDelay" : 0,
"priority" : 1,
"trackEnable" : true,
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
],
"vrrp6Role" : ""
},
"ipv6NtpDisable" : false,
"raHaltEnable" : false,
"managedAddressFlagEnable" : false
},
"configSource" : "Wan",
"ntpDisable" : false,
"unrHostRouteAdvertiseEnable" : false,
"dhcpTriggerEnable" : false,
"unrRoutesLimitEnable" : false,
"unrRoutesLimit" : 24
}
],
"fail" : [
{
"errcode" : "0",
"errmsg" : "",
"data" : {
"vpnId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"siteId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"id" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"interfaceType" : "interface",
"interfaceName" : "vlanif20",
"portLagFlag" : false,
"portId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"vlanId" : 1,
"subInterfaceName" : "GE0/0/0.1",
"trustEnable" : false,
"trust" : "dscp",
"ipAddress" : "192.168.1.1",
"prefixLength" : 24,
"secondaryIP" : ["10.10.10.2/24","10.10.11.2/24"],
"siteName" : "site",
"deviceName" : "device",
"vrrp" : {
"enable" : true,
"vrrpId" : 1,
"virtualIpAddress" : "10.1.1.1;10.1.2.1",
"defaultRole" : "master",
"preemptDelay" : 0,
"priority" : 1,
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
],
"vrrpList" : [
{
"vrrpId" : 1,
"virtualIpAddress" : "10.1.1.1;10.1.2.1",
"defaultRole" : "master",
"preemptDelay" : 0,
"priority" : 1,
"authMode" : 0,
"authKey" : "",
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
]
}
]
},
"dhcp" : {
"enable" : false,
"dhcpServiceType" : "server",
"dhcpServer" : {
"excludeIpGroups" : [
{
"startAddress" : "192.168.1.2",
"endAddress" : "192.168.1.3"
}
],
"leaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"voiceOption" : {
"asIp" : "192.168.1.10",
"ncpIp" : "192.168.1.10",
"voiceVlan" : 3,
"failOver" : {
"ipAddress" : "192.168.1.10",
"dialerString" : "12345678"
},
"description" : "description"
},
"dhcpOption" : [
{
"code" : 44,
"type" : "ascii",
"description" : "Wins/Netbios server",
"value" : "192.168.1.1"
}
],
"dhcpStatic" : [
{
"ipAddress" : "192.168.1.10",
"macAddress" : "xxxx-xxxx-xxxx"
}
],
"dns" : ["8.8.8.8","114.114.114.114"],
"domainName" : "example.com",
"useSecondaryIP" : false
},
"dhcpRelay" : {
"serverIps" : ["192.168.1.1"],
"sourceAddress" : "10.10.10.2",
"gatewayAddress" : "10.10.10.3",
"dhcpRelayOption82" : {
"function" : 0,
"vlanId" : 1,
"subOption" : [
{
"subOptionCode" : 0,
"isUserDefined" : true,
"value" : "\"ZID023301\""
}
]
},
"linkSelectionEnable" : true,
"linkSelectionAddress" : "10.10.10.1"
}
},
"securityZone" : "trust",
"proxyArp" : false,
"innerProxyArp" : false,
"attributes" : {
"mtu" : 1500,
"TCPmss" : 1200
},
"description" : "description",
"toVasEnable" : false,
"enableIpv4" : true,
"enableIpv6" : false,
"ipv6Info" : {
"ipv6Address" : "fc00:3::1",
"ipv6PrefixLength" : 64,
"dhcpV6Enable" : true,
"dhcpV6" : {
"dhcpv6ServiceType" : "server",
"dhcpv6Server" : {
"addressPrefix" : "fc00:3::/64",
"addressPrefixLeaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"delegationPrefix" : "fc00:3::/64",
"delegationPrefixAssignLength" : 64,
"delegationPrefixLeaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"excludeIpGroups" : [
{
"startAddress" : "fc00:1::1",
"endAddress" : "fc00:1::10"
}
],
"firstDnsServer" : "fc00:3::1",
"secondDnsServer" : "fc00:3::2",
"domainName" : "0"
},
"dhcpv6Relay" : {
"serverIps" : ["fc00::1"]
}
},
"vrrp6Enable" : true,
"vrrp6" : {
"vrrp6Id" : 1,
"virtualIpv6AddressLinkLocal" : "fe80::7",
"virtualIpv6Address" : "fc00:3::10;fc00:3::11",
"preemptDelay" : 0,
"priority" : 1,
"trackEnable" : true,
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
],
"vrrp6Role" : ""
},
"ipv6NtpDisable" : false,
"raHaltEnable" : false,
"managedAddressFlagEnable" : false
},
"configSource" : "Wan",
"ntpDisable" : false,
"unrHostRouteAdvertiseEnable" : false,
"dhcpTriggerEnable" : false,
"unrRoutesLimitEnable" : false,
"unrRoutesLimit" : 24
}
}
]
} 返回状态码为204:执行成功,没有数据。 HTTP/1.1 204 No Content
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
返回状态码为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
返回状态码为500:内部错误。 HTTP/1.1 500 Internal Server Error
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的示例 POST /controller/campus/v1/sdwan/overlay-network/ip-subnets/action/batch-delete 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
{
"IPSubnets" : [
{
"vpnId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"siteId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"id" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"interfaceType" : "interface",
"interfaceName" : "vlanif20",
"portLagFlag" : false,
"portId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"vlanId" : 1,
"subInterfaceName" : "GE0/0/0.1",
"trustEnable" : false,
"trust" : "dscp",
"ipAddress" : "192.168.1.1",
"prefixLength" : 24,
"secondaryIP" : ["10.10.10.2/24","10.10.11.2/24"],
"siteName" : "site",
"deviceName" : "device",
"vrrp" : {
"enable" : true,
"vrrpId" : 1,
"virtualIpAddress" : "10.1.1.1;10.1.2.1",
"defaultRole" : "master",
"preemptDelay" : 0,
"priority" : 1,
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
],
"vrrpList" : [
{
"vrrpId" : 1,
"virtualIpAddress" : "10.1.1.1;10.1.2.1",
"defaultRole" : "master",
"preemptDelay" : 0,
"priority" : 1,
"authMode" : 0,
"authKey" : "",
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
]
}
]
},
"dhcp" : {
"enable" : false,
"dhcpServiceType" : "server",
"dhcpServer" : {
"excludeIpGroups" : [
{
"startAddress" : "192.168.1.2",
"endAddress" : "192.168.1.3"
}
],
"leaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"voiceOption" : {
"asIp" : "192.168.1.10",
"ncpIp" : "192.168.1.10",
"voiceVlan" : 3,
"failOver" : {
"ipAddress" : "192.168.1.10",
"dialerString" : "12345678"
},
"description" : "description"
},
"dhcpOption" : [
{
"code" : 44,
"type" : "ascii",
"description" : "Wins/Netbios server",
"value" : "192.168.1.1"
}
],
"dhcpStatic" : [
{
"ipAddress" : "192.168.1.10",
"macAddress" : "xxxx-xxxx-xxxx"
}
],
"dns" : ["8.8.8.8","114.114.114.114"],
"domainName" : "example.com",
"useSecondaryIP" : false
},
"dhcpRelay" : {
"serverIps" : ["192.168.1.1"],
"sourceAddress" : "10.10.10.2",
"gatewayAddress" : "10.10.10.3",
"dhcpRelayOption82" : {
"function" : 0,
"vlanId" : 1,
"subOption" : [
{
"subOptionCode" : 0,
"isUserDefined" : true,
"value" : "\"ZID023301\""
}
]
},
"linkSelectionEnable" : true,
"linkSelectionAddress" : "10.10.10.1"
}
},
"securityZone" : "trust",
"proxyArp" : false,
"innerProxyArp" : false,
"attributes" : {
"mtu" : 1500,
"TCPmss" : 1200
},
"description" : "description",
"toVasEnable" : false,
"enableIpv4" : true,
"enableIpv6" : false,
"ipv6Info" : {
"ipv6Address" : "fc00:3::1",
"ipv6PrefixLength" : 64,
"dhcpV6Enable" : true,
"dhcpV6" : {
"dhcpv6ServiceType" : "server",
"dhcpv6Server" : {
"addressPrefix" : "fc00:3::/64",
"addressPrefixLeaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"delegationPrefix" : "fc00:3::/64",
"delegationPrefixAssignLength" : 64,
"delegationPrefixLeaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"excludeIpGroups" : [
{
"startAddress" : "fc00:1::1",
"endAddress" : "fc00:1::10"
}
],
"firstDnsServer" : "fc00:3::1",
"secondDnsServer" : "fc00:3::2",
"domainName" : "0"
},
"dhcpv6Relay" : {
"serverIps" : ["fc00::1"]
}
},
"vrrp6Enable" : true,
"vrrp6" : {
"vrrp6Id" : 1,
"virtualIpv6AddressLinkLocal" : "fe80::7",
"virtualIpv6Address" : "fc00:3::10;fc00:3::11",
"preemptDelay" : 0,
"priority" : 1,
"trackEnable" : true,
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
],
"vrrp6Role" : ""
},
"ipv6NtpDisable" : false,
"raHaltEnable" : false,
"managedAddressFlagEnable" : false
},
"configSource" : "Wan",
"ntpDisable" : false,
"unrHostRouteAdvertiseEnable" : false,
"dhcpTriggerEnable" : false,
"unrRoutesLimitEnable" : false,
"unrRoutesLimit" : 24
}
]
}
-
响应示例 返回状态码为200:接口调用成功,响应体参考IPSubnetResponse。 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" : "",
"success" : [
{
"vpnId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"siteId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"id" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"interfaceType" : "interface",
"interfaceName" : "vlanif20",
"portLagFlag" : false,
"portId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"vlanId" : 1,
"subInterfaceName" : "GE0/0/0.1",
"trustEnable" : false,
"trust" : "dscp",
"ipAddress" : "192.168.1.1",
"prefixLength" : 24,
"secondaryIP" : ["10.10.10.2/24","10.10.11.2/24"],
"siteName" : "site",
"deviceName" : "device",
"vrrp" : {
"enable" : true,
"vrrpId" : 1,
"virtualIpAddress" : "10.1.1.1;10.1.2.1",
"defaultRole" : "master",
"preemptDelay" : 0,
"priority" : 1,
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
],
"vrrpList" : [
{
"vrrpId" : 1,
"virtualIpAddress" : "10.1.1.1;10.1.2.1",
"defaultRole" : "master",
"preemptDelay" : 0,
"priority" : 1,
"authMode" : 0,
"authKey" : "",
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
]
}
]
},
"dhcp" : {
"enable" : false,
"dhcpServiceType" : "server",
"dhcpServer" : {
"excludeIpGroups" : [
{
"startAddress" : "192.168.1.2",
"endAddress" : "192.168.1.3"
}
],
"leaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"voiceOption" : {
"asIp" : "192.168.1.10",
"ncpIp" : "192.168.1.10",
"voiceVlan" : 3,
"failOver" : {
"ipAddress" : "192.168.1.10",
"dialerString" : "12345678"
},
"description" : "description"
},
"dhcpOption" : [
{
"code" : 44,
"type" : "ascii",
"description" : "Wins/Netbios server",
"value" : "192.168.1.1"
}
],
"dhcpStatic" : [
{
"ipAddress" : "192.168.1.10",
"macAddress" : "xxxx-xxxx-xxxx"
}
],
"dns" : ["8.8.8.8","114.114.114.114"],
"domainName" : "example.com",
"useSecondaryIP" : false
},
"dhcpRelay" : {
"serverIps" : ["192.168.1.1"],
"sourceAddress" : "10.10.10.2",
"gatewayAddress" : "10.10.10.3",
"dhcpRelayOption82" : {
"function" : 0,
"vlanId" : 1,
"subOption" : [
{
"subOptionCode" : 0,
"isUserDefined" : true,
"value" : "\"ZID023301\""
}
]
},
"linkSelectionEnable" : true,
"linkSelectionAddress" : "10.10.10.1"
}
},
"securityZone" : "trust",
"proxyArp" : false,
"innerProxyArp" : false,
"attributes" : {
"mtu" : 1500,
"TCPmss" : 1200
},
"description" : "description",
"toVasEnable" : false,
"enableIpv4" : true,
"enableIpv6" : false,
"ipv6Info" : {
"ipv6Address" : "fc00:3::1",
"ipv6PrefixLength" : 64,
"dhcpV6Enable" : true,
"dhcpV6" : {
"dhcpv6ServiceType" : "server",
"dhcpv6Server" : {
"addressPrefix" : "fc00:3::/64",
"addressPrefixLeaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"delegationPrefix" : "fc00:3::/64",
"delegationPrefixAssignLength" : 64,
"delegationPrefixLeaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"excludeIpGroups" : [
{
"startAddress" : "fc00:1::1",
"endAddress" : "fc00:1::10"
}
],
"firstDnsServer" : "fc00:3::1",
"secondDnsServer" : "fc00:3::2",
"domainName" : "0"
},
"dhcpv6Relay" : {
"serverIps" : ["fc00::1"]
}
},
"vrrp6Enable" : true,
"vrrp6" : {
"vrrp6Id" : 1,
"virtualIpv6AddressLinkLocal" : "fe80::7",
"virtualIpv6Address" : "fc00:3::10;fc00:3::11",
"preemptDelay" : 0,
"priority" : 1,
"trackEnable" : true,
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
],
"vrrp6Role" : ""
},
"ipv6NtpDisable" : false,
"raHaltEnable" : false,
"managedAddressFlagEnable" : false
},
"configSource" : "Wan",
"ntpDisable" : false,
"unrHostRouteAdvertiseEnable" : false,
"dhcpTriggerEnable" : false,
"unrRoutesLimitEnable" : false,
"unrRoutesLimit" : 24
}
],
"fail" : [
{
"errcode" : "0",
"errmsg" : "",
"data" : {
"vpnId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"siteId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"id" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"interfaceType" : "interface",
"interfaceName" : "vlanif20",
"portLagFlag" : false,
"portId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"vlanId" : 1,
"subInterfaceName" : "GE0/0/0.1",
"trustEnable" : false,
"trust" : "dscp",
"ipAddress" : "192.168.1.1",
"prefixLength" : 24,
"secondaryIP" : ["10.10.10.2/24","10.10.11.2/24"],
"siteName" : "site",
"deviceName" : "device",
"vrrp" : {
"enable" : true,
"vrrpId" : 1,
"virtualIpAddress" : "10.1.1.1;10.1.2.1",
"defaultRole" : "master",
"preemptDelay" : 0,
"priority" : 1,
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
],
"vrrpList" : [
{
"vrrpId" : 1,
"virtualIpAddress" : "10.1.1.1;10.1.2.1",
"defaultRole" : "master",
"preemptDelay" : 0,
"priority" : 1,
"authMode" : 0,
"authKey" : "",
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
]
}
]
},
"dhcp" : {
"enable" : false,
"dhcpServiceType" : "server",
"dhcpServer" : {
"excludeIpGroups" : [
{
"startAddress" : "192.168.1.2",
"endAddress" : "192.168.1.3"
}
],
"leaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"voiceOption" : {
"asIp" : "192.168.1.10",
"ncpIp" : "192.168.1.10",
"voiceVlan" : 3,
"failOver" : {
"ipAddress" : "192.168.1.10",
"dialerString" : "12345678"
},
"description" : "description"
},
"dhcpOption" : [
{
"code" : 44,
"type" : "ascii",
"description" : "Wins/Netbios server",
"value" : "192.168.1.1"
}
],
"dhcpStatic" : [
{
"ipAddress" : "192.168.1.10",
"macAddress" : "xxxx-xxxx-xxxx"
}
],
"dns" : ["8.8.8.8","114.114.114.114"],
"domainName" : "example.com",
"useSecondaryIP" : false
},
"dhcpRelay" : {
"serverIps" : ["192.168.1.1"],
"sourceAddress" : "10.10.10.2",
"gatewayAddress" : "10.10.10.3",
"dhcpRelayOption82" : {
"function" : 0,
"vlanId" : 1,
"subOption" : [
{
"subOptionCode" : 0,
"isUserDefined" : true,
"value" : "\"ZID023301\""
}
]
},
"linkSelectionEnable" : true,
"linkSelectionAddress" : "10.10.10.1"
}
},
"securityZone" : "trust",
"proxyArp" : false,
"innerProxyArp" : false,
"attributes" : {
"mtu" : 1500,
"TCPmss" : 1200
},
"description" : "description",
"toVasEnable" : false,
"enableIpv4" : true,
"enableIpv6" : false,
"ipv6Info" : {
"ipv6Address" : "fc00:3::1",
"ipv6PrefixLength" : 64,
"dhcpV6Enable" : true,
"dhcpV6" : {
"dhcpv6ServiceType" : "server",
"dhcpv6Server" : {
"addressPrefix" : "fc00:3::/64",
"addressPrefixLeaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"delegationPrefix" : "fc00:3::/64",
"delegationPrefixAssignLength" : 64,
"delegationPrefixLeaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"excludeIpGroups" : [
{
"startAddress" : "fc00:1::1",
"endAddress" : "fc00:1::10"
}
],
"firstDnsServer" : "fc00:3::1",
"secondDnsServer" : "fc00:3::2",
"domainName" : "0"
},
"dhcpv6Relay" : {
"serverIps" : ["fc00::1"]
}
},
"vrrp6Enable" : true,
"vrrp6" : {
"vrrp6Id" : 1,
"virtualIpv6AddressLinkLocal" : "fe80::7",
"virtualIpv6Address" : "fc00:3::10;fc00:3::11",
"preemptDelay" : 0,
"priority" : 1,
"trackEnable" : true,
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
],
"vrrp6Role" : ""
},
"ipv6NtpDisable" : false,
"raHaltEnable" : false,
"managedAddressFlagEnable" : false
},
"configSource" : "Wan",
"ntpDisable" : false,
"unrHostRouteAdvertiseEnable" : false,
"dhcpTriggerEnable" : false,
"unrRoutesLimitEnable" : false,
"unrRoutesLimit" : 24
}
}
]
} 返回状态码为204:执行成功,没有数据。 HTTP/1.1 204 No Content
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
返回状态码为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
返回状态码为500:内部错误。 HTTP/1.1 500 Internal Server Error
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/v1/sdwan/overlay-network/ip-subnets 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
{
"IPSubnets" : [
{
"vpnId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"siteId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"deviceId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"id" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"interfaceType" : "interface",
"interfaceName" : "vlanif20",
"portLagFlag" : false,
"portId" : "fbb684c8-0d37-496f-bafa-4b06d515j7l6",
"vlanId" : 1,
"subInterfaceName" : "GE0/0/0.1",
"trustEnable" : false,
"trust" : "dscp",
"ipAddress" : "192.168.1.1",
"prefixLength" : 24,
"secondaryIP" : ["10.10.10.2/24","10.10.11.2/24"],
"siteName" : "site",
"deviceName" : "device",
"vrrp" : {
"enable" : true,
"vrrpId" : 1,
"virtualIpAddress" : "10.1.1.1;10.1.2.1",
"defaultRole" : "master",
"preemptDelay" : 0,
"priority" : 1,
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
],
"vrrpList" : [
{
"vrrpId" : 1,
"virtualIpAddress" : "10.1.1.1;10.1.2.1",
"defaultRole" : "master",
"preemptDelay" : 0,
"priority" : 1,
"authMode" : 0,
"authKey" : "",
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
]
}
]
},
"dhcp" : {
"enable" : false,
"dhcpServiceType" : "server",
"dhcpServer" : {
"excludeIpGroups" : [
{
"startAddress" : "192.168.1.2",
"endAddress" : "192.168.1.3"
}
],
"leaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"voiceOption" : {
"asIp" : "192.168.1.10",
"ncpIp" : "192.168.1.10",
"voiceVlan" : 3,
"failOver" : {
"ipAddress" : "192.168.1.10",
"dialerString" : "12345678"
},
"description" : "description"
},
"dhcpOption" : [
{
"code" : 44,
"type" : "ascii",
"description" : "Wins/Netbios server",
"value" : "192.168.1.1"
}
],
"dhcpStatic" : [
{
"ipAddress" : "192.168.1.10",
"macAddress" : "xxxx-xxxx-xxxx"
}
],
"dns" : ["8.8.8.8","114.114.114.114"],
"domainName" : "example.com",
"useSecondaryIP" : false
},
"dhcpRelay" : {
"serverIps" : ["192.168.1.1"],
"sourceAddress" : "10.10.10.2",
"gatewayAddress" : "10.10.10.3",
"dhcpRelayOption82" : {
"function" : 0,
"vlanId" : 1,
"subOption" : [
{
"subOptionCode" : 0,
"isUserDefined" : true,
"value" : "\"ZID023301\""
}
]
},
"linkSelectionEnable" : true,
"linkSelectionAddress" : "10.10.10.1"
}
},
"securityZone" : "trust",
"proxyArp" : false,
"innerProxyArp" : false,
"attributes" : {
"mtu" : 1500,
"TCPmss" : 1200
},
"description" : "description",
"toVasEnable" : false,
"enableIpv4" : true,
"enableIpv6" : false,
"ipv6Info" : {
"ipv6Address" : "fc00:3::1",
"ipv6PrefixLength" : 64,
"dhcpV6Enable" : true,
"dhcpV6" : {
"dhcpv6ServiceType" : "server",
"dhcpv6Server" : {
"addressPrefix" : "fc00:3::/64",
"addressPrefixLeaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"delegationPrefix" : "fc00:3::/64",
"delegationPrefixAssignLength" : 64,
"delegationPrefixLeaseTime" : {
"day" : 0,
"hour" : 0,
"minute" : 0
},
"excludeIpGroups" : [
{
"startAddress" : "fc00:1::1",
"endAddress" : "fc00:1::10"
}
],
"firstDnsServer" : "fc00:3::1",
"secondDnsServer" : "fc00:3::2",
"domainName" : "0"
},
"dhcpv6Relay" : {
"serverIps" : ["fc00::1"]
}
},
"vrrp6Enable" : true,
"vrrp6" : {
"vrrp6Id" : 1,
"virtualIpv6AddressLinkLocal" : "fe80::7",
"virtualIpv6Address" : "fc00:3::10;fc00:3::11",
"preemptDelay" : 0,
"priority" : 1,
"trackEnable" : true,
"track" : [
{
"bfdSession" : {
"localDiscriminator" : 1,
"remoteDiscriminator" : 1,
"sourceIp" : "192.168.1.1",
"peerIp" : "192.168.1.1",
"interval" : 10
},
"interfaceName" : "GE0/0/1",
"addOrReduce" : "reduce",
"value" : 1,
"type" : "ipv4"
}
],
"vrrp6Role" : ""
},
"ipv6NtpDisable" : false,
"raHaltEnable" : false,
"managedAddressFlagEnable" : false
},
"configSource" : "Wan",
"ntpDisable" : false,
"unrHostRouteAdvertiseEnable" : false,
"dhcpTriggerEnable" : false,
"unrRoutesLimitEnable" : false,
"unrRoutesLimit" : 24
}
]
}