object item.update(object/array items)
此方法允许update现有的监控项.
Web 监控项无法通过Zabbix API进行更新.
此方法仅适用于Admin和Super admin 用户类型. 调用该方法的权限可以在用户角色 设置中撤销. 更多信息请参阅User roles.
(object/array)
监控项 待更新的属性.
每个监控项必须定义itemid
属性,其他 属性均为可选。仅传递的属性会被更新,其余 属性将保持不变。
除监控项外,该方法 还接受以下参数。
(object)
返回一个包含已更新object ID的监控项, 这些ID位于itemids
属性下。
启用一个监控项,即将其状态设置为"0".
请求:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "10092",
"status": 0
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}
响应:
更新依赖监控项名称和主监控项 ID。仅支持相同 主机 是被允许的,因此主节点和从属节点 监控项 应保持一致 hostid.
请求
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"name": "Dependent item updated name",
"master_itemid": "25562",
"itemid": "189019"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}
响应
启用 监控项 值捕获功能.
请求:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"allow_traps": 1
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}
响应:
使用预处理规则"In range"更新监控项与监控项
请求
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"preprocessing": [
{
"type": 13,
"params": "\n100",
"error_handler": 1,
"error_handler_params": ""
}
]
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}
响应
使用不同的脚本更新脚本监控项,并移除先前脚本使用的非必要参数。
请求:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23865",
"parameters": [],
"script": "Zabbix.Log(3, 'Log test');\nreturn 1;"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}
响应:
CItem::update() 位于 ui/include/classes/api/services/CItem.php 文件中。