这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.
2022 Zabbix中国峰会
2022 Zabbix中国峰会

创建

描述

object hostprototype.create(object/array hostPrototypes)

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

参数

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

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

参数 [ 型](/zh/manual/api/reference_commentary#data_types) 描述
groupLinks
(必选)
数组 要 主机原型创建的组链接
ruleid
(必选)
字符串 主机 型所属的LLD规则的ID。
groupPrototypes 数组 将 主机原型创建的组原型
macros 对象/数组 将为主 原型创建的用户宏
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 ui/include/classes/api/services/CHostPrototype.php.