get_bond_x 获取Bond设备参数

POST /api/v1/network/get_bond_x

描述

获取设备参数接口，用于获取指定设备的参数信息。这个接口用于在网络配置主页面显示指定设备的参数信息。对应命令 nmcli device show device。

访问权限

需要登录，具备以下权限：

network:get_connection_x

JSON参数

请求参数如下：

{
  "bondName": "string" // 设备名称，如bond0, bond1等
}

提示

bondName: 设备名称，如bond0, bond1等

响应结果

请求返回的HTTP状态码为200

返回结果为JSON格式的数据，您可以通过解析JSON数据来获取API调用的结果信息。结构如下：

{
  "success": true|false,
  "data"?: {
    "bondName": string, // 绑定连接名称，如bond0
    "slaves": [string], // 从属连接名称，如eth0, eth1等
    "mode": "balance-rr"|"active-backup"|"balance-xor"|"broadcast"|"802.3ad"|"balance-tlb"|"balance-alb", // 绑定模式
    "ipv4Method": "dhcp"|"manual", // IPv4地址获取方式：如dhcp, manual
    "ipv4Address": string, // IPv4地址 xxx/xx 格式， CIDR格式，可以多个用逗号分隔
    "ipv4Gateway": string, // IPv4网关
    "ipv6Method": "auto"|"dhcp"|"manual", // IPv6地址获取方式：如auto dhcp, manual
    "ipv6Address": string, // IPv6地址 xxx/xx 格式， CIDR格式，可以多个用逗号分隔
    "ipv6Gateway": string, // IPv6网关
    "tags": "tag1,tag2", // 设备标签, 用于用户备注用途
    "enabled": boolean, // 连接是否启用
    "bondOptions"?: {    // 绑定选项
			"miimon": "200",   // 毫秒，链路监测间隔时间，值为string类型
			"updelay": "0",   // 毫秒，链路恢复延迟时间, 值为string类型
			"downdelay": "0"  // 毫秒，链路断开延迟时间, 值为string类型
		}
  },
  "errorCode"?: "option string",
  "errorMessage"?: "option string",
  "showType"?: 0|1|2|4|9,
  "traceId"?: "option string"
}

提示

bondName : 绑定连接名称，如bond0
slaves : 从属连接名称，如eth0, eth1等
mode : 绑定模式
ipv4Method : IPv4地址获取方式：如dhcp, manual
ipv4Address : IPv4地址 xxx/xx 格式， CIDR格式，可以多个用逗号分隔
ipv4Gateway : IPv4网关
ipv6Method : IPv6地址获取方式：如auto dhcp, manual
ipv6Address : IPv6地址 xxx/xx 格式， CIDR格式，可以多个用逗号分隔
ipv6Gateway : IPv6网关
tags : 设备标签, 用于用户备注用途

模式选择说明

Bond模式完整对比：

模式名称	编号	工作原理	带宽特性	容错能力	适用场景	交换机要求	优点	缺点
balance-rr	0	轮询发送数据包	所有接口带宽之和	单接口失效自动切换	存储网络、大数据传输	静态聚合配置	负载均衡好、带宽高	可能包乱序、TCP性能下降
active-backup	1	主备切换模式	单接口带宽	自动故障转移	关键业务、高可用系统	无特殊要求	配置简单、稳定可靠	带宽受限、有切换延迟
balance-xor	2	MAC地址XOR哈希	理论上所有接口之和	单接口失效不影响其他	多客户端环境	静态聚合配置	避免包乱序、负载相对均衡	客户端少时负载不均
broadcast	3	所有接口同时发送	无带宽增益	最高容错性	极特殊场景、测试	无特殊要求	最高可用性	网络资源浪费严重
802.3ad	4	LACP动态协商	所有活跃接口之和	动态故障检测恢复	企业网络、数据中心	必须支持LACP	标准化、智能负载均衡	配置复杂、需协商时间
balance-tlb	5	发送负载均衡	发送：所有接口%%BR%%接收：单接口	发送流量自动重分布	上传密集应用	无特殊要求	无需交换机配置	仅优化发送方向
balance-alb	6	双向自适应均衡	理论上双向最大	全方位故障检测	高性能服务器	无特殊要求	性能最优、双向均衡	最复杂、环境敏感

快速选择指南

使用需求	首选模式	备选模式	选择理由
简单可靠	`active-backup`	`balance-xor`	配置简单，故障切换快
高带宽	`802.3ad`	`balance-alb`	标准化，性能稳定
无交换机配置权限	`balance-tlb`	`balance-alb`	不依赖交换机支持
多客户端负载均衡	`balance-xor`	`802.3ad`	避免包乱序问题
最高性能要求	`balance-alb`	`802.3ad`	双向负载均衡
最高可用性	`active-backup`	`broadcast`	故障转移可靠

get_bond_x 获取Bond设备参数

POST /api/v1/network/get_bond_x​

描述​

访问权限​

JSON参数​

响应结果​

模式选择说明​

POST /api/v1/network/get_bond_x

描述

访问权限

JSON参数

响应结果

模式选择说明