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