Table of Contents

item.update

item.update

Opis

object item.update(object/array items)

Ta metoda umożliwia aktualizację istniejących pozycji.

Pozycje scenariusza WWW nie mogą być aktualizowane za pomocą interfejsu API Zabbix.

Ta metoda jest dostępna tylko dla użytkowników typu Admin i Super admin. Uprawnienia do wywołania metody mogą być cofnięte w ustawieniach ról użytkownika. Zobacz Role użytkownika aby uzyskać więcej informacji.

Parametry

(object/array) Właściwości pozycji do zaktualizowania.

Właściwość itemid musi być zdefiniowana dla każdej pozycji, wszystkie inne właściwości są opcjonalne. Tylko przekazane właściwości zostaną zaktualizowane, wszystkie inne pozostaną niezmienione.

Dodatkowo do standardowych właściwości pozycji, metoda akceptuje następujące parametry.

Parametr	Typ	Opis
preprocessing	array	Opcje przetwarzania wstępnego pozycji do zastąpienia obecnymi opcjami przetwarzania wstępnego.
tags	array	Znaczniki pozycji.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych pozycji we właściwości itemids.

Przykłady

Włączanie pozycji

Włącz pozycję, czyli ustaw jej status na "0".

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "item.update",
           "params": {
               "itemid": "10092",
               "status": 0
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Odpowiedź:

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

Aktualizacja zależnej pozycji

Zaktualizuj nazwę zależnej pozycji oraz identyfikator głównej pozycji. Dozwolone są tylko zależności na tym samym hoście, dlatego też główna i zależna pozycja powinny mieć ten sam identyfikator hosta.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "item.update",
           "params": {
               "name": "Dependent item updated name",
               "master_itemid": "25562",
               "itemid": "189019"
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Odpowiedź:

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

Aktualizacja pozycji agenta HTTP

Włącz wyłapywanie wartości pozycji.

Zapytanie:

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

Odpowiedź:

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

Aktualizacja pozycji z przetwarzaniem wstępnym

Zaktualizuj pozycję z regułą przetwarzania wstępnego "W zakresie".

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "item.update",
           "params": {
               "itemid": "23856",
               "preprocessing": [
                   {
                       "type": 13,
                       "params": "\n100",
                       "error_handler": 1,
                       "error_handler_params": ""
                   }
               ]
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Odpowiedź:

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

Aktualizacja pozycji skryptowej

Zaktualizuj pozycję skryptową, zmieniając skrypt na inny i usuwając niepotrzebne parametry, które były używane przez poprzedni skrypt.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "item.update",
           "params": {
               "itemid": "23865",
               "parameters": [],
               "script": "Zabbix.Log(3, 'Log test');\nreturn 1;"
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Odpowiedź:

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

Źródło

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

Documentation

item.update

Opis

Parametry

Zwracane wartości

Przykłady

Włączanie pozycji

Aktualizacja zależnej pozycji

Aktualizacja pozycji agenta HTTP

Aktualizacja pozycji z przetwarzaniem wstępnym

Aktualizacja pozycji skryptowej

Źródło