这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

创建

描述

object triggerprototype.create(object/array triggerPrototypes)

这个方法可以创建新的触发器原型。

参数

(object/array)需要创建的触发器原型。 除standard trigger prototype properties之外,此方法还接受以下参数。

参数 类 说明
dependencies array 依赖触发器原型的触发器和触发器原型。

触发器必须已定义triggerid属性。
tags array 触发器原型标签。

<note important>指定的触发器表达式必须为展开式,并且必须包含至少一个监控项原型。 :::

返回值

(object)返回一个对象,该对象包含在triggerids属性中已创建触发器原型的ID,返回ID的顺序与传递触发器原型的顺序相匹配。

范例

创建触发器原型

创建一个触发器原型来检测磁盘剩余空间是否小于20%。

请求:

{
           "jsonrpc": "2.0",
           "method": "triggerprototype.create",
           "params": {
               "description": "Free disk space is less than 20% on volume {#FSNAME}",
               "expression": "{Zabbix server:vfs.fs.size[{#FSNAME},pfree].last()}<20",
               "tags": [
                   {
                       "tag": "volume",
                       "value": "{#FSNAME}"
                   },
                   {
                       "tag": "type",
                       "value": "{#FSTYPE}"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "triggerids": [
                   "17372"
               ]
           },
           "id": 1
       }

源码

CTriggerPrototype::create()方法可在frontends/php/include/classes/api/services/CTriggerPrototype.php中参考。