item.update

Opis

object item.update(object/array items)

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

Pozycji webowych nie można aktualizować za pośrednictwem Zabbix API.

Ta metoda jest dostępna tylko dla typów użytkowników Admin i Super admin. Uprawnienia do wywołania metody można odebrać w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji Role użytkowników.

Parametry

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

Właściwość itemid musi być zdefiniowana dla każdej 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 pozycji, metoda akceptuje następujące parametry.

Parametr Typ Opis
preprocessing array Opcje wstępnego przetwarzania pozycji, które zastąpią bieżące opcje wstępnego przetwarzania.

Zachowanie parametru:
- tylko do odczytu dla obiektów dziedziczonych lub obiektów wykrytych
tags array Tagi pozycji.

Zachowanie parametru:
- tylko do odczytu dla obiektów wykrytych

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”.

Żądanie:

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

Odpowiedź:

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

Aktualizacja zależnej pozycji

Zaktualizuj nazwę zależnej pozycji oraz ID pozycji nadrzędnej. Dozwolone są tylko zależności w obrębie tego samego hosta, dlatego pozycja nadrzędna i zależna pozycja powinny mieć ten sam hostid.

Żądanie:

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

Odpowiedź:

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

Aktualizacja pozycji HTTP agent

Włącz przechwytywanie wartości pozycji.

Żądanie:

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

Odpowiedź:

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

Aktualizacja pozycji z przetwarzaniem wstępnym

Zaktualizuj pozycję za pomocą reguły przetwarzania wstępnego pozycji „W zakresie”.

Żądanie:

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

Odpowiedź:

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

Aktualizowanie pozycji skryptowej

Zaktualizuj pozycję skryptową innym skryptem i usuń niepotrzebne parametry, które były używane przez poprzedni skrypt.

Żądanie:

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

Odpowiedź:

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

Źródło

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