创建

描述

object host.create(object/array **hosts**)

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

参数

(object/array) 要创建的主机。

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

属性类型描述
groups
(必选)		对象/数组添加主机的主机组。

主机组必须已定义groupid属性。
interfaces
(必选)		对象/数组为主机创建的接口。
tags对象/数组主机标签。
templates对象/数组链接到主机的模板。

模板必须已定义过templateid属性。
macros对象/数组为主机创建的用户宏。
inventory对象主机资产清单属性。

返回值

(object) 返回包含已创建主机ID的属性(hostid)，返回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接口的主机

创建一个带有SNMPv3接口的“SNMP host”主机包含以下信息。

请求：

  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.