跳到主要内容

get_connection_x 获取连接参数

POST /api/v1/network/get_connection_x​

描述​

获取以太网接口（物理接口）连接参数，用于获取指定网络连接的参数信息。 这个接口用于在网络配置主页面获取指定的网络连接参数信息。对应命令 nmcli connection show connection。 只能获取ethernet类型的连接参数，不能获取bond, vlan等类型的连接参数。

访问权限​

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

network:get_connection_x

JSON参数​

请求参数如下：

{
  "device": "string" // 连接名称，如eth_ntp0, eth_ntp1等, 不支持bond, vlan等类型的连接
}
提示
  • device: 设备名称，如eth0, eth1等

响应结果​

请求返回的HTTP状态码为200

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

{
  "success": true|false,
  "data"?: {
    "device": "string", // 网口设备名称：如eth0, eth1等
    "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 // 连接是否启用
  },
  "errorCode"?: "option string",
  "errorMessage"?: "option string",
  "showType"?: 0|1|2|4|9,
  "traceId"?: "option string"
}