itemprototype.update
Apraksts
object itemprototype.update(object/array itemPrototypes)
Šī metode ļauj atjaunināt esošos vienumu prototipus.
Šī metode ir pieejama tikai Admin un Super admin lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā Lietotāju lomas.
Parametri
(object/array) Atjaunināmo vienumu prototipu īpašības.
Īpašībai itemid jābūt definētai katram vienuma prototipam, 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 vienumu prototipu īpašībām metode pieņem šādus parametrus.
| Parametrs | Tips | Apraksts |
|---|---|---|
| preprocessing | array | Vienuma prototipa 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 |
| tags | array | Vienuma prototipa birkas. |
Atgrieztās vērtības
(object) Atgriež objektu, kas satur atjaunināto vienumu prototipu ID īpašumā itemids.
Piemēri
Vienuma prototipa saskarnes maiņa
Mainiet hosta saskarni, kas tiks izmantota atklātajiem vienumiem.
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid": "27428",
"interfaceid": "132"
},
"id": 1
}
Atbilde:
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"27428"
]
},
"id": 1
}
Atjaunināt atkarīgā vienuma prototipu
Atjauniniet atkarīgā vienuma prototipu ar jaunu galvenā vienuma prototipa ID. Ir atļautas tikai atkarības uz tā paša hosta (veidnes/atklāšanas kārtulas), tādēļ galvenajam un atkarīgajam vienumam jābūt ar vienādu hostid un ruleid.
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"master_itemid": "25570",
"itemid": "189030"
},
"id": 1
}
Atbilde:
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"189030"
]
},
"id": 1
}
Atjaunināt HTTP aģenta vienuma prototipu
Mainīt vaicājuma laukus un noņemt visas pielāgotās galvenes.
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid":"28305",
"query_fields": [
{
"name": "random",
"value": "qwertyuiopasdfghjklzxcvbnm"
}
],
"headers": []
}
"id": 1
}
Atbilde:
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"28305"
]
},
"id": 1
}
Vienuma prototipa priekšapstrādes opciju atjaunināšana
Atjauniniet vienuma prototipu ar vienuma priekšapstrādes noteikumu “Pielāgots reizinātājs”.
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid": "44211",
"preprocessing": [
{
"type": 1,
"params": "4",
"error_handler": 2,
"error_handler_params": "5"
}
]
},
"id": 1
}
Atbilde:
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"44211"
]
},
"id": 1
}
Skripta vienuma prototipa atjaunināšana
Atjauniniet skripta vienuma prototipu ar citu skriptu un noņemiet nevajadzīgos parametrus, kas tika izmantoti iepriekšējā skriptā.
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid": "23865",
"parameters": [],
"script": "Zabbix.log(3, 'Log test');\nreturn 1;"
},
"id": 1
}
Atbilde:
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"23865"
]
},
"id": 1
}
Avots
CItemPrototype::update() failā ui/include/classes/api/services/CItemPrototype.php.