Table of Contents

itemprototype.update

itemprototype.update

Opis

object itemprototype.update(object/array itemPrototypes)

Ta metoda pozwala na aktualizację istniejących prototypów pozycji.

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

Parametry

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

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

Oprócz standardowych właściwości prototypu pozycji, metoda przyjmuje następujące parametry.

Parametr	Typ	Opis
preprocessing	array	Opcje przetwarzania wstępnego prototypu pozycji w celu zastąpienia bieżących opcji przetwarzania.
tags	array	Znaczniki prototypu pozycji.

Zwracane wartości

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

Przykłady

Zmiana interfejsu prototypu pozycji

Zmień interfejs hosta, który będzie używany przez wykryte pozycje.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.update",
           "params": {
               "itemid": "27428",
               "interfaceid": "132"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Odpowiedź:

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

Aktualizacja zależnego prototypu pozycji

Zaktualizuj zależny prototyp pozycji, przypisując nowe ID głównego prototypu pozycji. Dozwolone są tylko zależności w obrębie tego samego hosta (szablonu/reguły odkrywania), dlatego też główny i zależny prototyp powinny mieć ten sam hostid i ruleid.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.update",
           "params": {
               "master_itemid": "25570",
               "itemid": "189030"
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Odpowiedź:

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

Aktualizacja prototypu pozycji agenta HTTP

Zmień pola zapytania i usuń wszystkie niestandardowe nagłówki.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.update",
           "params": {
               "itemid":"28305",
               "query_fields": [
                   {
                       "random": "qwertyuiopasdfghjklzxcvbnm"
                   }
               ],
               "headers": []
           }
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Odpowiedź:

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

Aktualizacja opcji przetwarzania wstępnego pozycji

Zaktualizuj prototyp pozycji z regułą przetwarzania wstępnego pozycji “własny mnożnik“.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.update",
           "params": {
               "itemid": "44211",
               "preprocessing": [
                   {
                       "type": 1,
                       "params": "4",
                       "error_handler": 2,
                       "error_handler_params": "5"
                   }
               ]
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Odpowiedź:

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

Aktualizacja prototypu pozycji typu skrypt

Zaktualizuj prototyp pozycji typu skrypt innym skryptem i usuń niepotrzebne parametry, które były używane przez poprzedni skrypt.

Odpowiedź:

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

Zapytanie:

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

Źródło

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

Documentation

itemprototype.update

Opis

Parametry

Zwracane wartości

Przykłady

Zmiana interfejsu prototypu pozycji

Aktualizacja zależnego prototypu pozycji

Aktualizacja prototypu pozycji agenta HTTP

Aktualizacja opcji przetwarzania wstępnego pozycji

Aktualizacja prototypu pozycji typu skrypt

Źródło