item.update

Опис

object item.update(object/array items)

Овај метод вам омогућава да ажурирате постојеће ставке.

::: ::: noteclassic Веб ставке се не могу ажурирати преко Zabbix API-ја. :::

Овај метод је доступан само за Администратор и Супер администратор типове корисника. Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте Корисничке улоге за више информација.

Параметри

(object/array) Својства ставке која се ажурирају.

Својство itemid мора бити дефинисано за сваку ставку, сва остала својства су опциона. Биће ажурирана само прослеђена својства, сва друга ће остати непромењена.

Поред стандардних својстава ставке, метод прихвата следеће параметре.

Parameter Type Description
preprocessing array Предобрада ставке опције за замену тренутних опција за предобраду.

Понашање параметра:
-само за читање за наслеђене објекте или откривене објекте
tags array Ознаке ставки.

Понашање параметра:
- само за читање за откривене објекте

Повратне вредности

(object) Враћа објекат који садржи ID-ијеве ажурираних ставки у оквиру својства itemids.

Примери

Омогућавање ставке

Омогућите ставку, односно, поставите њен статус на "0".

Захтев:

{
           "jsonrpc": "2.0",
           "method": "item.update",
           "params": {
               "itemid": "10092",
               "status": 0
           },
           "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"
           },
           "id": 1
       }

Одговор:

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

Ажурирај ставку HTTP агента

Омогућите заробљивање вредности ставке.

Захтев:

{
           "jsonrpc": "2.0",
           "method": "item.update",
           "params": {
               "itemid": "23856",
               "allow_traps": 1
           },
           "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": ""
                   }
               ]
           },
           "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;"
            },
            "id": 1
       }

Одговор:

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

Извор

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