item.update

Opis

object item.update(object/array items)

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

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.

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.