更新
说明
object item.update(object/array items)
此方法用于更新既存监控项。
无法通过 Zabbix API 更新 Web 监控项。
此方法仅允许 Admin（管理员） 和 Super admin（超级管理员） 类型的用户使用。调用此方法的权限可以在用户角色设置中撤销。更多信息请参阅 用户角色 。
说明
(object/array) 监控项目标更新属性.
每个监控项都必须定义 itemid 属性，其余属性为可选项。仅传递的属性将被更新，所有其他属性将保持不变。
除了 标准监控项属性 之外，此方法同样适用以下参数。
返回值
(object) 返回一个对象，该对象包含 itemids 属性下更新的监控项的 ID。
示例
启用监控项
启用监控项，即将其状态设置为 “0” 。
请求：
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "10092",
"status": 0
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}响应：
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"10092"
]
},
"id": 1
}更新依赖监控项
更新依赖监控项名称和主监控项 ID。仅允许依赖于同一主机，因此主监控项和依赖监控项应具有相同的主机 ID。
请求：
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"name": "Dependent item updated name",
"master_itemid": "25562",
"itemid": "189019"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}更新：
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"189019"
]
},
"id": 1
}更新 HTTP agent 监控项
启用监控项状态值捕获。
请求：
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"allow_traps": "1"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}响应：
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"23856"
]
},
"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",
"result": {
"itemids": [
"23856"
]
},
"id": 1
}更新脚本监控项
更新脚本监控项为其他脚本，并删除在旧脚本中使用的非必要参数。
请求：
{
"jsonrpc": "2.0",
"method": "item.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
}源码
ui/include/classes/api/services/CItem.php - CItem::update()