主题
接口描述
提交汇聚相关的信息
注:仅提交接口 dialType 参数为 staticNetCouple(固定公网多 IP)的节点可进行汇聚信息提交
请求路径
POST/v1/nodes/<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 | 是 | 物理网卡名 |
| vlanInfos | []VlanInfo | body | 是 | 拨号账号列表 |
VlanInfo
| 名称 | 类型 | 位置 | 必须 | 描述 |
|---|---|---|---|---|
| ip | string | body | 是 | 静态 IP |
| gateway | string | body | 是 | 网关 |
| ipv6 | string | body | 否 | 静态 IP(IPV6) |
| ipv6Gateway | string | body | 否 | 网关(IPV6) |
| mask | string | body | 是 | 子网掩码 |
| vlanId | int | body | 是 | vlanId |
| mac | string | body | 否 | MAC 地址 |
返回值
| 名称 | 类型 | 描述 |
|---|
请求示例
json
{
"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"
}
]
}
]
}返回值示例
json
正常请求:
http code 200
异常请求:
http code 4xx/5xx
{
"code": 4000001,
"desc": ""
}错误码列表
| 错误码 | 描述 |
|---|---|
| 401 | 鉴权失败 |
| 4000002 | 节点未查找到 |
如接口返回错误码未列举,可在错误码总览中查找