Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

更新监控项原型

描述

object itemprototype.update(object/array itemPrototypes)

此方法用于更新已存在的监控项原型。

此方法仅适用于管理员超级管理员用户类型。可以在用户角色设置中撤销调用该方法的权限。了解更多信息请参见用户角色

参数

(object/array)要更新的监控项的属性。

每个的监控项的itemid属性必须被定义,其他属性可选。只有被传递的属性才会更新,其他所有属性保持不变。

另外见标准监控项原型,此方法接受如下参数。

参数 类型 描述
applications array 要替换当前应用的应用的ID。
preprocessing array 要替换的当前监控项预处理选项。

返回值

(object) 返回一个对象,其中包含 itemids 属性下更新的监控项原型的 ID。

案例

修改监控项原型接口

修改自动发现监控项的主机接口。

请求:

{
        · "jsonrpc": "2.0",
        · "method": "itemprototype.update",
        · "params": {
        · "itemid": "27428",
        · "interfaceid": "132"
        · },
        · "auth": "038e1d7b1735c6a5436ee9eae095879e",
        · "id": 1
       }

返回:

{
        · "jsonrpc": "2.0",
        · "result": {
        · "itemids": [
        · "27428"
        · ]
        · },
        · "id": 1
       }

更新依赖监控项原型

使用新主监控项原型ID更新依赖监控项原型。 只允许依赖于同一主机(模板/发现规则)监控项原型,因此主监控项原型和从属监控项原型应具有相同的 hostid 和 ruleid。

请求:

{
        · "jsonrpc": "2.0",
        · "method": "itemprototype.update",
        · "params": {
        · "master_itemid": "25570",
        · "itemid": "189030"
        · },
        · "auth": "700ca65537074ec963db7efabda78259",
        · "id": 1
       }

返回:

{
        · "jsonrpc": "2.0",
        · "result": {
        · "itemids": [
        · "189030"
        · ]
        · },
        · "id": 1
       }

更新HTTP代理监控项原型

修改查询字段和移除所有自定义的头部。

请求:

{
        · "jsonrpc": "2.0",
        · "method": "itemprototype.update",
        · "params": {
        · "itemid":"28305",
        · "query_fields": [
        · {
        · "random": "qwertyuiopasdfghjklzxcvbnm"
        · }
        · ],
        · "headers": []
        · }
        · "auth": "700ca65537074ec963db7efabda78259",
        · "id": 1
       }

返回:

{
        · "jsonrpc": "2.0",
        · "result": {
        · "itemids": [
        · "28305"
        · ]
        · },
        · "id": 1
       }

更新监控项原型预处理选项

使用监控项原型预处理规则“自定义乘数”更新监控项。

请求:

{
        · "jsonrpc": "2.0",
        · "method": "itemprototype.update",
        · "params": {
        · "itemid": "44211",
        · "preprocessing": [
        · {
        · "type": "1",
        · "params": "4",
        · "error_handler": "2",
        · "error_handler_params": "5"
        · }
        · ]
        · },
        · "auth": "700ca65537074ec963db7efabda78259",
        · "id": 1
       }

返回:

{
        · "jsonrpc": "2.0",
        · "result": {
        · "itemids": [
        · "44211"
        · ]
        · },
        · "id": 1
       }

更新监控项原型脚本

使用不同的脚本更新监控项原型脚本,删除先前脚本使用的不必要参数。

请求:

{
        · "jsonrpc": "2.0",
        · "method": "itemprototype.update",
        · "params": {
        · "itemid": "23865",
        · "parameters": [],
        · "script": "Zabbix.Log(3, 'Log test');\nreturn 1;"
        · },
        · "auth": "700ca65537074ec963db7efabda78259",
        · "id": 1
       }

返回:

{
        · "jsonrpc": "2.0",
        · "result": {
        · "itemids": [
        · "23865"
        · ]
        · },
        · "id": 1
       }

来源

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