2022 Zabbix中国峰会
2022 Zabbix中国峰会

创建

描述

object hostprototype.create(object/array hostPrototypes)

此方法允许创建新的主机原型.

参数

(对象/数组) 要创建的主机原型.

标准主机原型属性之外,该方法接受以下参数.

参数 类 描述
groupLinks
(必选)
数组 要 主机原型创建的组链接.
ruleid
(必选)
字符串 主机 型所属的LLD规则的ID.
groupPrototypes 数组 将 主机原型创建的组原型.
inventory 对象 主 原型资产属性.
templates 对象/数组 连接到 机原型的模板.

模板必须已定义templateid属性.

返回值

(object)hostids属性中返回已创建主机原型ID的对象,返回ID的顺序与传入主机原型的顺序一致.

示例

创建主机原型

使用组原型{#HV.NAME}为LLD规则23542,创建主机原型{#VM.NAME},连接到主机组2

请求:

{
           "jsonrpc": "2.0",
           "method": "hostprototype.create",
           "params": {
               "host": "{#VM.NAME}",
               "ruleid": "23542",
               "groupLinks": [
                   {
                       "groupid": "2"
                   }
               ],
               "groupPrototypes": [
                   {
                       "name": "{#HV.NAME}"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10103"
               ]
           },
           "id": 1
       }

参考

来源

CHostPrototype::create() in frontends/php/include/classes/api/services/CHostPrototype.php.