这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

更新

说明

object item.update(object/array items)

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

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

参数

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

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

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

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

返回值

(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.

Source

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