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

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

更新模板

描述

object template.update(object/array templates)

此方法允许更新现有模板。

此方法仅适用于管理员超级管理员用户类型。可以在用户角色设置中撤销调用该方法的权限。 详情请阅 User roles

参数

(object/array) 要更新的模板属性。

必须为每个模板定义templateid属性,其他所有属性都是可选的。只有给定的属性将被更新,所有其他属性将保持不变。

除了标准模版属性,该方法接受以下参数。

参数 类型 描述
groups object/array 用于替换模板所属的当前主机组的主机群组

主机组必须定义groupid属性。
tags object/array 替换当前模板标记的模板标签
macros object/array 用户宏替换给定模板上的当前用户宏
templates object/array 替换当前链接的模板的模版。未传递的模板仅被取消链接。

模板必须定义templateid属性。
templates_clear object/array 取消链接并清除给定模板的模版

模板必须定义templateid属性。

返回值

(object) 返回一个对象,该对象包含templateids属性下已更新模板的ID。

示例

重命名一个模版

将模板重命名为“template OS Linux”。

请求:

{
           "jsonrpc": "2.0",
           "method": "template.update",
           "params": {
               "templateid": "10086",
               "name": "Template OS Linux"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "templateids": [
                   "10086"
               ]
           },
           "id": 1
       }

更新模版标签

用新的模板标签替换所有模板标签。

请求:

{
           "jsonrpc": "2.0",
           "method": "template.update",
           "params": {
               "templateid": "10086",
               "tags": [
                   {
                       "tag": "Host name",
                       "value": "{HOST.NAME}"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

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

源码

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