更新

说明

object item.update(object/array **items**)

此方法允许更新已存在的监控项。

WEB监控项不能通过Zabbix API更新。

参数

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

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

另外见standard item properties，此方法接受如下参数。

返回值

(object) 在itemids属性下返回已被更新的监控项的对象的IDs。

示例

启用一个监控项

启用一个监控项就是设置他的status属性为“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。只有同一个主机上的依赖监控项才允许，因此主监控项和依赖监控项应有相同的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",
    "result": {
        "itemids": [
            "189019"
        ]
    },
    "id": 1
}

更新 HTTP agent 监控项

启用监控项的trapping值。

请求:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "23856",
        "allow_traps": "1"
    },
    "auth": "700ca65537074ec963db7efabda78259",
    "id": 1
}

响应:

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

来源

CItem::update() in frontends/php/include/classes/api/services/CItem.php.