Documentation
Table of Contents
hostprototype.update
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
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/matriz) Propiedades del prototipo del equipo que se actualizar¨¢n.
La propiedad hostid debe definirse para cada prototipo de equipo, todas las dem¨¢s propiedades son opcionales. S¨®lo se actualizar¨¢n las propiedades pasadas, todas las dem¨¢s permanecer¨¢n sin cambios.
Adem¨¢s de las propiedades de prototipo de equipo est¨¢ndar, el m¨¦todo acepta los siguientes par¨¢metros.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| groupLinks | matriz | Enlaces de grupo para reemplazar los enlaces de grupo actuales en el prototipo de equipo. Comportamiento del par¨¢metro: - solo lectura para objetos heredados |
| groupPrototypes | matriz | Prototipos de grupo para reemplazar los prototipos de grupo existentes en el prototipo del equipo. Comportamiento del par¨¢metro: - solo lectura para objetos heredados |
| macros | object/matriz | Macros de usuario para reemplazar las macros de usuario actuales. Se eliminar¨¢n todas las macros que no aparezcan en la solicitud. |
| tags | object/matriz | Etiquetas de prototipo de equipo para reemplazar las etiquetas actuales. Se eliminar¨¢n todas las etiquetas que no aparezcan en la solicitud.<br > Comportamiento de par¨¢metros: - solo lectura para objetos heredados |
| interfaces | object/matriz | Prototipo de host interfaces personalizadas para reemplazar las interfaces actuales. El objeto de interfaz personalizado debe contener todos sus par¨¢metros. Todas las interfaces que no figuran en la solicitud se eliminar¨¢n. Comportamiento de par¨¢metros: - compatible si interfaces_personalizadas de objeto prototipo de host est¨¢ configurado para "usar interfaces personalizadas de prototipos de equipo"- solo lectura para objetos heredados |
| templates | object/matriz | Plantillas para reemplazar las plantillas actualmente vinculadas. Las plantillas deben tener solo la propiedad templateid definida. |
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 prototipos de equipo
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:
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.