Documentation
Table of Contents
host.create
描述
object host.create(object/array hosts)
此方法用于 create 新的 主机。
此方法仅适用于 管理员 和 超级管理员 用户类型。调用该方法的权限可以在用户角色设置中撤销。更多信息请参见 User roles。
参数
(object/array) 主机 to create.
除了 主机 外，该方法还接受以下参数。
| 参数 | 数据类型 | 描述 |
|---|---|---|
| groups | object/array | Host groups 添加 主机 到的主机。 主机 组只能定义 groupid 属性。参数行为: - 必填 |
| interfaces | object/array | 为 主机 创建的 Interfaces。 |
| tags | object/array | 主机标签。 |
| templates | object/array | 要链接到 主机 的 Templates。 模板只能定义 templateid 属性。 |
| macros | object/array | 为 主机 创建的 User macros。 |
| inventory | object | 主机资产清单 属性。 |
返回值
(object) 返回一个 object，其中包含在 hostids 属性下列出的已创建 主机 的 ID。返回的 ID 顺序与传入的 主机 顺序一致。
示例
创建主机
创建名为“Linux服务器”的一个主机，配置IP接口和标签， 将其添加到主机组，关联模板并在主机资产清单中设置MAC地址。
执行请求:
{ "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Linux server", "interfaces": [ { "type": 1, "main": 1, "useip": 1, "ip": "192.168.3.1", "dns": "", "port": "10050" } ], "groups": [ { "groupid": "50" } ], "tags": [ { "tag": "host-name", "value": "linux-server" } ], "templates": [ { "templateid": "20045" } ], "macros": [ { "macro": "{$USER_ID}", "value": "123321" }, { "macro": "{$USER_LOCATION}", "value": "0:0:0", "description": "latitude, longitude and altitude coordinates" } ], "inventory_mode": 0, "inventory": { "macaddress_a": "01234", "macaddress_b": "56768" } }, "id": 1 }响应：
创建带有 SNMP 接口的主机
创建名为“SNMP 主机”的一个主机，并配置具有详细信息的 SNMPv3 接口。
执行请求:
{ "jsonrpc": "2.0", "method": "host.create", "params": { "host": "SNMP host", "interfaces": [ { "type": 2, "main": 1, "useip": 1, "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": 3, "bulk": 0, "securityname": "mysecurityname", "contextname": "", "securitylevel": 1 } } ], "groups": [ { "groupid": "4" } ] }, "id": 1 }响应：
创建使用PSK加密的主机
创建名为“PSK 主机”的一个主机，并配置PSK加密。 请注意，主机必须为为服务器agent通信配置psk示例。
执行请求:
{ "jsonrpc": "2.0", "method": "host.create", "params": { "host": "PSK host", "interfaces": [ { "type": 1, "ip": "192.168.3.1", "dns": "", "port": "10050", "useip": 1, "main": 1 } ], "groups": [ { "groupid": "2" } ], "tls_accept": 2, "tls_connect": 2, "tls_psk_identity": "PSK 001", "tls_psk": "1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952" }, "id": 1 }响应:
由 proxy 监控的 一个主机 创建
创建由具有 ID "1" 的 proxy 监控的 一个主机。
执行请求:
{ "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Host monitored by proxy", "groups": [ { "groupid": "2" } ], "monitored_by": 1, "proxyid": 1 }, "id": 1 }响应:
由 proxy 组 监控的 一个主机 创建
创建由具有 ID "1" 的 proxy 组 监控的 一个主机。
执行请求:
{ "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Host monitored by proxy group", "groups": [ { "groupid": "2" } ], "monitored_by": 2, "proxy_groupid": 1 }, "id": 1 }响应：
另请参阅
来源
在 ui/include/classes/api/services/CHost.php 中的 CHost::create()。