Documentation
Table of Contents
itemprototype.update
Descripción
object itemprototype.update(object/array itemPrototypes)
Este método permite actualizar prototipos de item existentes.
Este método solo está disponible para los tipos de usuario Administrador y Superadministrador. Los permisos para activar el método se pueden revocar en la configuración del rol de usuario. Ver User roles para más información.
Parámetros
(object/array) Item prototype properties to be updated.
La propiedad itemid debe definirse para cada prototipo de item, todas las demás propiedades son opcionales. Sólo se actualizarán las propiedades pasadas, todas las otras permanecerán sin cambios.
Además de las propiedades de standard item prototypeproperties, el método acepta los siguientes parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
| preprocessing | matriz | Opciones de preprocessing del prototipo de item para reemplazar las opciones de preprocesamiento actuales. |
| tags | matriz | tags del prototipo de item. |
Valores de retorno
(object) Devuelve un objeto que contiene los ID de los prototipos de item actualizados bajo la propiedad itemids.
Ejemplos
Cambiar la interfaz de un prototipo de item
Cambie la interfaz del host que utilizarán los items descubiertos.
Solicitud:
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid": "27428",
"interfaceid": "132"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Respuesta:
Actualizar el prototipo de de item dependiente
Actualice el prototipo de item dependiente con el nuevo ID del prototipo de item Principal. Solo se permiten dependencias en el mismo host (template/discovery rule), por lo tanto, los items principal y dependiente deben tener el mismo ID de host e ID de regla.
Solicitud:
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"master_itemid": "25570",
"itemid": "189030"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Respuesta:
Actualizar el prototipo de métrica del agente HTTP
Cambie los campos de consulta y elimine todos los encabezados personalizados.
Solicitud:
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid":"28305",
"query_fields": [
{
"random": "qwertyuiopasdfghjklzxcvbnm"
}
],
"headers": []
}
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Respuesta:
Actualización de opciones de preprocesamiento de items
Actualizar un prototipo de item con la regla de preprocesamiento de item "multiplicador personalizado".
Solicitud:
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid": "44211",
"preprocessing": [
{
"type": 1,
"params": "4",
"error_handler": 2,
"error_handler_params": "5"
}
]
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Respuesta:
Actualización de un item de secuencia de comandos
Actualice un item de secuencia de comandos con una secuencia de comandos diferente y elimine los parámetros innecesarios que utilizó la secuencia de comandos anterior.
Solicitud:
{
"jsonrpc": "2.0",
"method": "itemprototype.update",
"params": {
"itemid": "23865",
"parameters": [],
"script": "Zabbix.Log(3, 'Log test');\nreturn 1;"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Respuesta:
Fuente
CItemPrototype::update() en ui/include/classes/api/services/CItemPrototype.php.