创建

描述

object host.create(object/array hosts)

这个方法可以用来创建主机。

这个方法仅允许 管理员 和 超级管理员 用户类型。可以在用户角色中撤销调用方法的权限设置。参考 User roles获取详情

参数

(对象/数组) 要创建的主机。

另外，对于标准的主机属性,该方法接受下列参数。

参数类型描述
groups
(必选)		object/array把主机添加到目标组。

主机组必须已定义 groupid 属性。
interfacesobject/array为主机创建的接口。
tagsobject/array主机标签。
templatesobject/array主机连接的模板。

模板必须已定义templateid属性。
macrosobject/array为主机创建的用户宏。
inventoryobject主机资产清单属性。

返回值

(对象) 返回包含已创建主机ID的属性 hostids ，返回ID的顺序与传入主机的顺序一致。

示例

创建一个主机

创建一个具有IP接口和标签的“Linux Server”主机，将其添加到主机组中，链接一个模板并且把MAC地址设置到主机资产清单里。

请求:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "host.create",
  4.            "params": {
  5.                "host": "Linux server",
  6.                "interfaces": [
  7.                    {
  8.                        "type": 1,
  9.                        "main": 1,
  10.                        "useip": 1,
  11.                        "ip": "192.168.3.1",
  12.                        "dns": "",
  13.                        "port": "10050"
  14.                    }
  15.                ],
  16.                "groups": [
  17.                    {
  18.                        "groupid": "50"
  19.                    }
  20.                ],
  21.                "tags": [
  22.                    {
  23.                        "tag": "Host name",
  24.                        "value": "Linux server"
  25.                    }
  26.                ],
  27.                "templates": [
  28.                    {
  29.                        "templateid": "20045"
  30.                    }
  31.                ],
  32.                "macros": [
  33.                    {
  34.                        "macro": "{$USER_ID}",
  35.                        "value": "123321"
  36.                    },
  37.                    {
  38.                        "macro": "{$USER_LOCATION}",
  39.                        "value": "0:0:0",
  40.                        "description": "latitude, longitude and altitude coordinates"
  41.                    }
  42.                ],
  43.                "inventory_mode": 0,
  44.                "inventory": {
  45.                    "macaddress_a": "01234",
  46.                    "macaddress_b": "56768"
  47.                }
  48.            },
  49.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
  50.            "id": 1
  51.        }

响应:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "result": {
  4.                "hostids": [
  5.                    "107819"
  6.                ]
  7.            },
  8.            "id": 1
  9.        }

创建一个具有SNMP接口的主机

创建一个名为“SNMP host”的主机，并创建SNMPv3接口。

请求:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "host.create",
  4.            "params": {
  5.                "host": "SNMP host",
  6.                "interfaces": [
  7.                    {
  8.                        "type": 2,
  9.                        "main": 1,
  10.                        "useip": 1,
  11.                        "ip": "127.0.0.1",
  12.                        "dns": "",
  13.                        "port": "161",
  14.                        "details": {
  15.                            "version": 3,
  16.                            "bulk": 0,
  17.                            "securityname": "mysecurityname",
  18.                            "contextname": "",
  19.                            "securitylevel": 1
  20.                        }
  21.                    }
  22.                ],
  23.                "groups": [
  24.                    {
  25.                        "groupid": "4"
  26.                    }
  27.                ]
  28.            },
  29.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
  30.            "id": 1
  31.        }

响应:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "result": {
  4.                "hostids": [
  5.                    "10658"
  6.                ]
  7.            },
  8.            "id": 1
  9.        }

参考

源代码

CHost::create() in ui/include/classes/api/services/CHost.php.