object hostprototype.update(object/array hostPrototypes)
Este método permite actualizar los prototipos de equipo existentes.
Este método solo está disponible para los tipos de usuariosAdministrador y Superadministrador. Los permisos para activar el método se pueden revocar en los ajustes de rol de usuario. Ver Roles de usuario para más información.
(objeto/array)
Propiedades del prototipo de host que se actualizarán.
La propiedad hostid
debe estar definida para cada prototipo de host, todas las demás propiedades son opcionales. Solo se actualizarán las propiedades enviadas, todas las demás permanecerán sin cambios.
Además de las propiedades estándar del prototipo de host, el método acepta los siguientes parámetros.
Parámetro | Tipo | Descripción |
---|---|---|
groupLinks | array | Vínculos de grupo para reemplazar los vínculos de grupo actuales en el prototipo de host. Comportamiento del parámetro: - solo lectura para objetos heredados |
groupPrototypes | array | Prototipos de grupo para reemplazar los prototipos de grupo existentes en el prototipo de host. Todos los prototipos de grupo que no se incluyan en la solicitud serán eliminados. Comportamiento del parámetro: - solo lectura para objetos heredados |
macros | objeto/array | Macros de usuario para reemplazar las macros de usuario actuales. Todas las macros que no se incluyan en la solicitud serán eliminadas. |
tags | objeto/array | Etiquetas de prototipo de host para reemplazar las etiquetas actuales. Todas las etiquetas que no se incluyan en la solicitud serán eliminadas. Comportamiento del parámetro: - solo lectura para objetos heredados |
interfaces | objeto/array | Interfaces personalizadas del prototipo de host para reemplazar las interfaces actuales. El objeto de interfaz personalizada debe contener todos sus parámetros. Todas las interfaces que no se incluyan en la solicitud serán eliminadas. Comportamiento del parámetro: - soportado si custom_interfaces del objeto Prototipo de host está configurado en "usar interfaces personalizadas de prototipos de host"- solo lectura para objetos heredados |
templates | objeto/array | Plantillas para reemplazar las plantillas actualmente vinculadas. Las plantillas deben tener definida solo la propiedad templateid . |
(objeto)
Devuelve un objeto que contiene los ID de los prototipos de equipos actualizados bajo la propiedad hostids
.
Deshabilite un prototipo de equipo, es decir, establezca su estado en "1".
{
"jsonrpc": "2.0",
"method": "hostprototype.update",
"params": {
"hostid": "10092",
"status": 1
},
"id": 1
}
Respuesta:
Reemplace las etiquetas de prototipos de equipo por otras nuevas.
{
"jsonrpc": "2.0",
"method": "hostprototype.update",
"params": {
"hostid": "10092",
"tags": [
{
"tag": "datacenter",
"value": "{#DATACENTER.NAME}"
},
{
"tag": "instance-type",
"value": "{#INSTANCE_TYPE}"
}
]
},
"id": 1
}
Respuesta:
Reemplace las interfaces heredadas con interfaces personalizadas del prototipo de equipo.
{
"jsonrpc": "2.0",
"method": "hostprototype.update",
"params": {
"hostid": "10092",
"custom_interfaces": "1",
"interfaces": [
{
"main": "1",
"type": "2",
"useip": "1",
"ip": "127.0.0.1",
"dns": "",
"port": "161",
"details": {
"version": "2",
"bulk": "1",
"community": "{$SNMP_COMMUNITY}"
}
}
]
},
"id": 1
}
Respuesta:
CHostPrototype::update() en ui/include/classes/api/services/CHostPrototype.php.