接口描述

提交汇聚相关的信息

注：仅提交接口 dialType 参数为 staticNetCouple（固定公网多 IP）或 dhcpNetCouple（DHCP 多 IP）的节点可进行汇聚信息提交

请求路径

POST /v1/ant/<nodeID>/dialconverge/submit

请求参数

名称	类型	位置	必须	描述
Authorization	string	header	是	鉴权 token
Content-Type	string	header	是	数据类型 application/json
nodeID	string	path	是	节点 ID
managerNetDevName	string	body	否	管理口物理网卡名，managerNetDevName 和 convergeInfos 至少有一个传入
convergeInfos	[]ConvergeInfo	body	否	网卡和汇聚详细列表

ConvergeInfo

名称	类型	位置	必须	描述
netDevName	string	body	是	物理网卡名
ipv6Dhcp	bool	body	否	是否开启 IPv6 DHCP（网卡级别，默认 false）
vlanInfos	[]VlanInfo	body	是	拨号账号列表

VlanInfo

名称	类型	位置	必须	描述
ip	string	body	否	静态 IP，staticNetCouple 必填；dhcpNetCouple（DHCP 多 IP）不填
gateway	string	body	否	网关，staticNetCouple 时随 ip 一起填写
ipv6	string	body	否	静态 IP(IPV6)
ipv6Gateway	string	body	否	网关(IPV6)
mask	string	body	否	子网掩码，staticNetCouple 时随 ip 一起填写
vlanId	int	body	是	vlanId，DHCP 多 IP 线路填 0
mac	string	body	否	MAC 地址

返回值

名称	类型	描述

请求示例

staticNetCouple（固定公网多 IP）：

{
  "managerNetDevName": "eth0",
  "convergeInfos": [
    {
      "netDevName": "eth1",
      "vlanInfos": [
        {
          "ip": "127.0.0.1",
          "gateway": "172.0.0.1",
          "ipv6": "::1",
          "ipv6Gateway": "2001::1",
          "mask": "255.255.255.0",
          "vlanId": 10,
          "mac": "ff:ee:cc:dd:aa:bb"
        }
      ]
    }
  ]
}

dhcpNetCouple（DHCP 多 IP）：不填 ip/gateway/mask，vlanId 填 0，一条 vlanInfo 对应一条 DHCP 线路

{
  "managerNetDevName": "eth0",
  "convergeInfos": [
    {
      "netDevName": "eth1",
      "ipv6Dhcp": true,
      "vlanInfos": [
        {
          "vlanId": 0
        },
        {
          "vlanId": 0
        }
      ]
    }
  ]
}

返回值示例

正常请求:
  http code 200
异常请求:
  http code 4xx/5xx
{
  "code": 4000001,
  "desc": ""
}

错误码列表

错误码	描述
401	鉴权失败
4000002	节点未查找到

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