Documentation
Table of Contents
hostprototype.update
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
object hostprototype.update(object/array hostPrototypes)
Aquest m¨¨tode permet actualitzar els prototips d'equips.
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.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ
(object/array) Propietats del prototip d'equips per actualitzar.
La propietat hostid s'ha d'establir per a cada prototip d'equips, 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 d'objecte de prototip d'equips est¨¤ndard] (object#host_prototype), el m¨¨tode admet els par¨¤metres seg¨¹ents.
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| groupLinks | array | Enlla?os de grups substituint els enlla?os de grup existents al prototip d'equips. Comportament de la propietat: - nom¨¦s lectura per objectes heretats |
| groupPrototypes | array | Prototips de grups substituint els prototips de grup existents al prototip d'equips. S'esborraran tots els prototips de grups que no siguin llistats a la petici¨®. Comportament de la propietat: - nom¨¦s lectura per objectes heretats |
| macros | object/array | Macros d'usuari que substitueixen les macros existents. S'esborraran les macros que no s¨®n pas a la petici¨®. |
| tags | object/array | Etiquetes dels prototips d'equips que substitueixen les etiquetes actuals. S'esborraran les etiquetes que no s¨®n pas a la petici¨®. Comportament de la propietat: - nom¨¦s lectura per objectes heretats |
| interfaces | object/array | Interf¨ªcies personalitzades prototips d'equips que substitueixen les interf¨ªcies actuals. L'objecte d'interf¨ªcie personalitzada hauria de contindre tots els seus par¨¤metres . Totes les interf¨ªcies que no s¨®n pas a la petici¨® s'esborraran. Comportament de la propietat: - ²¹»å³¾¨¨²õ si custom_interfaces dels objectes prototip d'equip s'ha establert a "emprar interf¨ªcies personalitzades de prototip d'equips"- nom¨¦s lectura per objectes heretats |
| templates | object/array | Plantilles que substitueixen les plantilles enlla?ades actualment. Les plantilles han de tindre la propietat templateid establerta. |
Valors de retorn
(object) Retorna un objecte contingut als IDs dels prototipus d'equips actualitzats sota la propietat hostids.
Exemples
Desactivar un prototip d'equip
Desactiva un prototip d'equip; ¨¦s a dir, estableix el seu estat a "1".
{
"jsonrpc": "2.0",
"method": "hostprototype.update",
"params": {
"hostid": "10092",
"status": 1
},
"id": 1
}Resposta:
Actualitzar les etiquetes de prototips d'equips
Actualitzar les etiquetes de prototips d'equips per les noves.
{
"jsonrpc": "2.0",
"method": "hostprototype.update",
"params": {
"hostid": "10092",
"tags": [
{
"tag": "datacenter",
"value": "{#DATACENTER.NAME}"
},
{
"tag": "instance-type",
"value": "{#INSTANCE_TYPE}"
}
]
},
"id": 1
}Resposta:
Actualitzar les interf¨ªcies personalitzades de prototips d'equips
Reempla?ar les interf¨ªcies heretades per les interf¨ªcies personalitzades de prototip d'equips.
{
"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
}Resposta:
Veieu tamb¨¦
Font
CHostPrototype::update() in ui/include/classes/api/services/CHostPrototype.php.