itemprototype.update

Opis

object itemprototype.update(object/array itemPrototypes)

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

Parametry

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

Właściwość itemid musi być zdefiniowana dla każdego prototypu pozycji, wszystkie pozostałe właściwości są opcjonalne. Zaktualizowane zostaną tylko przekazane właściwości, wszystkie pozostałe pozostaną bez zmian.

Oprócz standardowych właściwości prototypu pozycji, metoda akceptuje 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.

Żądanie:

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

Odpowiedź:

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

Aktualizacja prototypu zależnej pozycji

Zaktualizuj prototyp zależnej pozycji, podając nowe ID prototypu pozycji nadrzędnej. Dozwolone są tylko zależności w obrębie tego samego hosta (szablonu/reguły wykrywania), dlatego pozycja nadrzędna i zależna pozycja powinny mieć takie samo hostid i ruleid.

Żądanie:

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

Odpowiedź:

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

Aktualizacja prototypu pozycji HTTP agent

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

Żądanie:

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

Odpowiedź:

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

Aktualizacja opcji przetwarzania wstępnego pozycji

Zaktualizuj prototyp pozycji za pomocą reguły przetwarzania wstępnego pozycji „Mnożnik niestandardowy”.

Żądanie:

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

Odpowiedź:

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

Aktualizowanie prototypu pozycji skryptowej

Zaktualizuj prototyp pozycji skryptowej, używając innego skryptu, i usuń zbędne parametry, które były używane przez poprzedni skrypt.

Żądanie:

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

Odpowiedź:

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

Źródło

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