Documentation
Table of Contents
hostprototype.update
Descripción
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.
Parámetros
(objeto/matriz) Propiedades del prototipo del equipo que se actualizarán.
La propiedad hostid debe definirse para cada prototipo de equipo, todos 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 estándar de prototipo de equipo, el método acepta los siguientes parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
| groupLinks | array | Grupo de enlaces para reemplazar los enlaces de grupo actuales en el prototipo de equipo. Comportamiento de parámetros: - solo lectura para objetos heredados |
| groupPrototypes | matriz | Grupo de prototipos para reemplazar los grupos de prototipos existentes en el prototipo del equipo. Comportamiento de parámetros: - solo lectura para objetos heredados |
| macros | objeto/matriz | Macros de usuario para reemplazar las macros de usuario actuales. Se eliminarán todas las macros que no figuran en la solicitud. |
| tags | object/Matriz | Etiquetas del prototipo de equipo para reemplazar las etiquetas actuales. Todas las etiquetas que no figuran en la solicitud se eliminarán . Comportamiento de parámetros: - solo lectura para objetos heredados |
| interfaces | object/array | Interfaces personalizadasdel prototipo de equipo para reemplazar las interfaces actuales. El objeto de interfaz personalizado debe contener todos sus parámetros.<br >Se eliminarán todas las interfaces que no aparezcan en la solicitud. Comportamiento de parámetros: - compatible si interfaces_personalizadas de Objeto prototipo de equipo está configurado para "usar interfaces personalizadas de prototipos de equipo"- solo lectura para objetos heredados |
| templates | objeto/matriz | Plantillas para reemplazar las plantillas actualmente vinculadas. Las plantillas deben tener definida la propiedad templateid. |
Valores de retorno
(objeto) Devuelve un objeto que contiene los ID de los prototipos de equipos actualizados bajo la propiedad hostids.
Ejemplos
Deshabilitar un prototipo de equipo
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:
Actualización de etiquetas de prototipo de equipo
Reemplace las etiquetas del prototipo 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:
Actualización de interfaces personalizadas del prototipo de equipo
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:
Ver también
- Enlace de grupo
- Prototipo de grupo
- Etiqueta de prototipo de host
- Interfaz personalizada
- Macro de usuario
Fuente
CHostPrototype::update() en ui/include/classes/api/services/CHostPrototype.php.