DCIM API 文档 / 服务器 / 服务器添加
▍概述
添加服务器
▍URL
/index.php?m=api&a=hardwareAdd
▍请求参数
字段名 | 变量名 | 必填 | 类型 | 描述 |
---|---|---|---|---|
物理标签 | wltag | 是 | string | 服务器物理标签 |
硬件型号 | type | 否 | int | 硬件型号ID,调用/index.php?m=api&a=getHardwareAssort,获取由id(硬件型号ID)和name(硬件型号名称)组成的二维数组 |
pdu设备id | pdu | 否 | int | 连接PDU设备ID,调用/index.php?m=api&a=getPdu,获取由id(PDU设备ID)和name(PDU设备名称)组成的二维数组 |
pdu设备端口 | pdu_num | 否 | int | 连接PDU设备端口,调用/index.php?m=api&a=pduNum,传递参数id(选择的PDU设备ID),获取由PDU设备端口号组成的一维数组 |
交换机id | switch | 否 | array,下标为public时为主交换机 | 连接交换机ID,调用/index.php?m=api&a=getSwitch,获取由id(交换机ID)和sname(交换机名称)组成的二维数组 |
交换机端口 | switch_num | 否 | array,下标为public时为主交换机端口 | 连接交换机端口,调用/index.php?m=api&a=switchNum,传递参数id(选择的交换机ID),获取由交换机端口号组成的一维数组 |
机柜id | cabinet | 否 | int | 所属机柜ID,调用/index.php?m=api&a=getCabinet,获取由id(机柜ID)和name(机柜名称)组成的二维数组 |
上架时间 | time | 否 | date | 服务器上架时间(例如:2017-10-24) |
内部标签 | nbtag | 否 | string | 服务器内部标签 |
服务器类型 | server_type | 是 | int | 服务器类型(1:租用,2:自用,3:虚拟机母鸡,4:虚拟机小鸡,5:托管,8:机柜) |
服务器分配IP | ipid | 否 | array | 分配的IP的ID,调用(/index.php?m=api&a=getIps,传递type参数获取IP段,type允许的值:(public,client,intranet,other),返回一个由id(IP段ID)和ipsection(IP段)组成的二维数组,传递id参数(IP段ID)到/index.php?m=api&a=getIp,返回一个由id(IP的ID)和ipaddress(IP地址)组成的二维数组) |
服务器分配IP | ipaddress | 否 | array | 以ip地址分配ip,若有ipid该参数不会生效 |
服务器系统id | osid | 否 | int | 服务器系统ID,调用/index.php?m=api&a=getServerOs,获取由id(系统ID)和name(系统名称)组成的二维数组 |
服务器IPMI地址 | ipmi_ip | 否 | string|int | 服务器IPMI ip地址或者管理系统IP id |
服务器IPMI用户名 | ipmi_name | 否 | string | 服务器IPMI用户名 |
服务器IPMI密码 | ipmi_pass | 否 | string | 服务器IPMI密码 |
▍返回参数
字段名 | 变量名 | 类型 | 描述 |
---|---|---|---|
状态 | status | string | success 成功 error 失败 |
服务器ID | id | int | 添加的服务器id |
信息 | msg | string | 提示信息 |