Skip to main content

save_connection_x 添加连接

POST /api/v1/network/save_connection_x​

描述​

保存以太网连接接口（物理接口）的连接参数，支持启用/禁用接口和IPv4/IPv6网络配置。

  • 启用：为接口分配IP地址，提供网络连接
  • 禁用：关闭IP分配但保持链路UP，保留配置文件以便后续恢复
  • 启用接口时进行冲突检测，禁用时跳过检测；

Bond冲突检测说明：

  • 检测内容：该接口是否已被某个启用的Bond作为slave设备使用
  • 冲突处理：返回错误，不允许保存
  • 原因：一个接口不能既作为Bond的slave，又独立配置IP

VLAN冲突检测

  • 检测内容：该接口是否已被某个启用的VLAN作为主设备使用
  • 冲突处理：返回错误，不允许保存
  • 原因：VLAN主设备应该只做链路转发，不应分配IP地址，否则会导致网络冲突

访问权限​

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

network:save_connection_x

JSON参数​

请求参数如下：

{
  "device": string, // 选定的设备名称，如eth_ntp0, eth_ntp1等, 不支持bond, vlan等类型的连接
  "macAddress": string, // MAC地址
  "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": true|false // 连接是否启用
}
tip
  • device : 选定的设备名称，如eth0, eth1等
  • macAddress : MAC地址
  • ipv4Method : IPv4地址获取方式：如dhcp, manual
  • ipv4Address : IPv4地址 xxx/xx 格式， CIDR格式，可以多个用逗号分隔
  • ipv4Gateway : IPv4网关
  • ipv6Method : IPv6地址获取方式：如auto dhcp, manual
  • ipv6Address : IPv6地址 xxx/xx 格式， CIDR格式，可以多个用逗号分隔
  • ipv6Gateway : IPv6网关
  • tags : 设备标签, 用于用户备注用途
  • enabled : 连接是否启用

响应结果​

请求返回的HTTP状态码为200

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

{
  "success": true|false,
  "errorCode"?: "option string",
  "errorMessage"?: "option string",
  "showType"?: 0|1|2|4|9,
  "traceId"?: "option string"
}