交换机添加
本文说明智简魔方 DCIM 系统中“交换机添加”相关的接口或函数信息，供开发人员在集成、调用和排查问题时参考。
概述
添加交换机
URL
/index.php?m=api&a=switchAdd请求参数
| 字段名 | 变量名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 交换机名称 | sname | 是 | string | 交换机名称 |
| 交换机标签 | sname_tag | 否 | string | 交换机内部标签 |
| 交换机类型 | type | 否 | int | 交换机类型（1：自用公网，2：自用 ipmi，3：自用内网，4：租用，5：托管，6：机柜，7：其他），默认为自用公网 |
| 设备类型 | device | 否 | string | 设备类型（switch：交换机，router：路由器，firewall：防火墙，other：其他），默认为交换机 |
| 端口数量 | portnum | 否 | int | 交换机下端口的数量 |
| 分配 IP | ipaddress | 否 | int | 分配的 IP 的 ID，调用（/index.php?m=api&a=getIps，传递 type 参数获取 IP 段，type 允许的值：（public，client，ipmi，intranet，other），返回一个由 ID（IP 段 ID）和 ipsection（IP 段）组成的二维数组，传递 ID 参数（IP 段 ID）到/index.php?m=api&a=getIp，返回一个由 ID（IP 的 ID）和 ipaddress（IP 地址）组成的二维数组） |
| 机柜 | cabinet | 否 | int | 所属机柜 ID，调用/index.php?m=api&a=getCabinet，获取由 ID（机柜 ID）和 name（机柜名称）组成的二维数组 |
| 机柜物理位置 | position_u | 否 | string | 设备物理位置 |
| 设备具体位置 | position_style | 否 | string | 设备具体位置 |
| 位置大小 | u | 否 | int | 交换机占用位置大小 |
| 型号 | version | 否 | string | 交换机型号 |
| 密码 | pwd | 否 | string | 密码 |
| Telnet 用户名 | telnetuname | 否 | string | Telnet 用户名 |
| Telnet 密码 | telnetpwd | 否 | string | Telnet 密码 |
| VLAN | vlan | 否 | string | VLAN（用，分隔开，例如 12,14,15,16-22） |
| SNMP 团体名 | snmp | 否 | string | SNMP 团体名 |
| 脚本执行文件 | switch_sh_file | 否 | string | 脚本执行文件，调用/index.php?m=api&a=getShFile，传递参数 conn（Telnet，SSH）获取脚本执行文件数组 |
| 连接方式 | attest | 否 | string | 连接方式（Telnet，SSH） |
| 有无用户名 | nousername | 否 | int | 交换机有无 Telnet 用户名（0：有，1：无） |
| 功能支持 | features | 否 | string | 交换机支持的功能，调用/index.php?m=api&a=getShConfig，传递参数 attest（连接方式）以及 switch_sh_file（脚本执行文件）获取，返回一个数组（support：功能支持，用于传递给后台，supportName：支持的功能名称组成的数组，unsupportName：不支持的功能名称组成的数组） |
| 控制支持 | ipmi_support | 否 | string | 交换机是否支持控制（true：支持，false：不支持） |
返回参数
| 字段名 | 变量名 | 类型 | 描述 |
|---|---|---|---|
| 状态 | status | string | success 成功 error 失败 |
| 交换机 ID | id | int | 添加的交换机 ID |
| 信息 | msg | string | 提示信息 |