itemprototype.update

Opis

object itemprototype.update(object/array itemPrototypes)

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

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.

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.