vienums.update

Apraksts

object item.update(object/array items)

Šī metode ļauj atjaunināt esošos vienumus.

Tīmekļa vienumus nevar atjaunināt, izmantojot Zabbix API.

Šī metode ir pieejama tikai Admin un Super admin lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāju lomu iestatījumos. Plašāku informāciju skatiet Lietotāju lomas.

Parametri

(object/array) Atjaunināmo vienumu īpašības.

Īpašībai itemid jābūt definētai katram vienumam, visas pārējās īpašības nav obligātas. Tiks atjauninātas tikai nodotās īpašības, visas pārējās paliks nemainītas.

Papildus standarta vienuma īpašībām metode pieņem šādus parametrus.

Parametrs Type Apraksts
preprocessing array Vienuma priekšapstrādes opcijas, ar kurām aizstāt pašreizējās priekšapstrādes opcijas.

Parametra darbība:
- tikai lasāms mantotajiem objektiem vai atklātajiem objektiem
tags array Vienuma birkas.

Parametra darbība:
- tikai lasāms atklātajiem objektiem

Atgrieztās vērtības

(object) Atgriež objektu, kas satur atjaunināto vienumu ID zem itemids īpašības.

Piemēri

Vienuma iespējošana

Iespējojiet vienumu, tas ir, iestatiet tā statusu uz "0".

Pieprasījums:

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

Atbilde:

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

Atjaunināt atkarīgo vienumu

Atjauniniet atkarīgā vienuma nosaukumu un galvenā vienuma ID. Ir atļautas tikai atkarības vienā un tajā pašā hostā, tādēļ galvenajam un atkarīgajam vienumam jābūt ar vienādu hostid.

Pieprasījums:

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

Atbilde:

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

Atjaunināt HTTP aģenta vienumu

Iespējot vienuma vērtību uztveršanu.

Pieprasījums:

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

Atbilde:

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

Vienuma atjaunināšana ar priekšapstrādi

Atjauniniet vienumu ar vienuma priekšapstrādes noteikumu "Diapazonā".

Pieprasījums:

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

Atbilde:

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

Skripta vienuma atjaunināšana

Atjauniniet skripta vienumu ar citu skriptu un noņemiet nevajadzīgos parametrus, kas tika izmantoti iepriekšējā skriptā.

Pieprasījums:

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

Atbilde:

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

Avots

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