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

triggerprototype.update

描述

object triggerprototype.update(object/array triggerPrototypes)

此方法允许更新已有的触发器原型.

此方法只有Admin(管理员)Super admin(超级管理员)用户可用。可以在用户角色设置中撤销调用该方法的权限。 更多信息请查看 用户角色

参数

(object/array) 需要更新的触发器原型

必须在每个触发器原型中定义triggerid属性,其他所有属性为可选项。只有传递过去的属性会被更新,其他所有属性保持不变。

除了 标准的触发器原型属性之外 ,该方法还接受以下参数.

参数 类型 描述
dependencies array 触发器原型所依赖的触发器和触发器原型.

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

在扩展表单中必须填入至少包含一个监控项原型的触发器表达式。

返回值

(object)返回一个对象,该对象是包含在triggerids属性中已更新触发器原型的ID.

示例

启用触发器原型

启用一个触发器原型,即将其状态设置为0.

请求:

{
           "jsonrpc": "2.0",
           "method": "triggerprototype.update",
           "params": {
               "triggerid": "13938",
               "status": 0
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

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

替换触发器原型标签

为触发器原型替换标签.

请求:

{
           "jsonrpc": "2.0",
           "method": "triggerprototype.update",
           "params": {
               "triggerid": "17373",
               "tags": [
                   {
                       "tag": "volume",
                       "value": "{#FSNAME}"
                   },
                   {
                       "tag": "type",
                       "value": "{#FSTYPE}"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

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

源码

CTriggerPrototype::update() in ui/include/classes/api/services/CTriggerPrototype.php.