Zabbix Documentation 4.4

объект item.update(объект/массив элементы данных)

Этот метод позволяет обновлять существующие элементы данных.

(объект/массив) Свойства элементов данных, которые будут обновлены.

Свойство itemid должно быть указано по каждому элементу данных, все остальные свойства опциональны. Будут обновлены только переданные свойства, все остальные останутся неизменными.

В дополнение к стандартным свойствам элемента данных, этот метод принимает следующие параметры.

(объект) Возвращает объект, который содержит ID обновленных элементов данных под свойством itemids.

Активация элемента данных, то есть изменение его состояния на значение “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
}

Активация трапов получения значений элемента данных.

Запрос:

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

Ответ:

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

Обновление элемента данных с правилом предобработки “По диапазону”.

Запрос:

{
    "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
}

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