Documentation
Table of Contents
itemprototype.update
Descripció
object itemprototype.update(object/array itemPrototypes)
Aquest mètode permet actualitzar els prototips d'elements.
Aquest mètode és disponible només per als usuaris de tipus Admin i Super admin. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu Rols d'usuari.
Paràmetres
(object/array) Propietats del prototip d'element a actualitzar.
La propietat itemid s'ha d'establir per a cada prototip d'element, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.
A més de les [propietats estàndard del prototip d'element] (object#item_prototype), el mètode admet els paràmetres següents.
| Paràmetre | Tipus | Descripció |
|---|---|---|
| preprocessing | array | Preprocessament del prototip d'element per anul·lar les opcions de preprocessament actuals. Comportament de la propietat: - només lectura per objectes heretats |
| tags | array | Etiquetes del prototip d'element. |
Valors de retorn
(object) Retorna un objecte contingut als IDs dels prototipus d'elements actualitzats sota la propietat itemids.
Exemples
Canviar la interfície d'un prototip d'element
Canviar la interfície d'equip que s'emprarà per als elements descoberts.
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid": "27428",
"interfaceid": "132"
},
"id": 1
}Resposta:
Actualitzar el prototip d'element dependent
actualitzar el prototip d'element dependent amb el nou ID de prototip d'element principal. Només es permeten les dependències del mateix equip (plantilla / regla de descoberta). Per tant, els elements mestre i dependent han de tindre els mateixos hostid i ruleid.
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"master_itemid": "25570",
"itemid": "189030"
},
"id": 1
}Resposta:
Actualitzar el prototip d'element d'agent HTTP
Canviar els camps de consulta i esborrar totes les capçaleres personalitzades.
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid":"28305",
"query_fields": [
{
"name": "random",
"value": "qwertyuiopasdfghjklzxcvbnm"
}
],
"headers": []
}
"id": 1
}Resposta:
Actualitzar les opcions de preprocessament d'elements
Actualitzar un prototip d'element amb la regla de preprocessament d'element “Multiplicador a mida”.
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid": "44211",
"preprocessing": [
{
"type": 1,
"params": "4",
"error_handler": 2,
"error_handler_params": "5"
}
]
},
"id": 1
}Resposta:
Actualitzar un prototip d'element d'script
Actualitzar un prototip d'element d'script amb un script diferent, i esborrar els paràmetres obsolets que emprava l'script antic.
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid": "23865",
"parameters": [],
"script": "Zabbix.Log(3, 'Log test');\nreturn 1;"
},
"id": 1
}Resposta:
Font
CItemPrototype::update() in ui/include/classes/api/services/CItemPrototype.php.