template.update
Descripció
object template.update(object/array templates)
Aquest mètode permet actualitzar plantilles.
Tenim aquest mètode disponible només per als usuaris Admin i Super admin. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu Rols d'usuari.
Paràmetres
(object/array) Propietats de la plantilla a actualitzar.
La propietat templateid s'ha d'establir per a cada plantilla, totes les altres propietats són opcionals. Només s'actualitzaran les propietats indicades, les altres romandran sense canvis.
A més de les propietats de l'objecte del model estàndard, el mètode admet els paràmetres següents.
| Paràmetre | Tipus | Descripció |
|---|---|---|
| groups | object/array | Grups d'equips substituint els grups d'equips actuals als quals pertanyen les plantilles. Els grups d'equips han de tindre només la propietat groupid establerta. |
| tags | object/array | etiquetes de plantilla substituint les existents. |
| macros | object/array | Macros d'usuari substituint les macros d'usuari actuals en models determinats. |
| templates | object/array | Plantilles substituint les plantilles enllaçades actualment. Les plantilles que no es passen només estan desvinculades. Les plantilles han de tindre només la propietat templateid establerta. |
| templates_clear | object/array | [Templates(/manual/api/reference/template/object) per desenllaçar i esborrar les plantilles donades. Les plantilles han de tindre només la propietat templateid establerta. |
Valors de retorn
(object) Torna un objecte que contingui els IDs de les plantilles actualitzades sota la propietat templatids.
Exemples
Canviar les propietats de la plantilla estàndard
Canvi del nom tècnic de la plantilla a "Linux by Zabbix agent Custom", el nom visible a "My template" i actualització la descripció de la plantilla.
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"host": "Linux by Zabbix agent Custom",
"name": "My template",
"description": "This is a custom Linux template."
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10086"
]
},
"id": 1
}Actualització de grups de plantilles
Substitució de tots els grups de plantilles de la plantilla donada per una de diferent.
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"groups": [
{
"groupid": "24"
}
]
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10086"
]
},
"id": 1
}Actualitzar les etiquetes de plantilles
Reemplaça totes les etiquetes d'una plantilla per una de diferent.
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"tags": [
{
"tag": "host-name",
"value": "{HOST.NAME}"
}
]
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10086"
]
},
"id": 1
}Actualitzar les etiquetes de plantilles
Reemplaçar totes les etiquetes d'una plantilla per una de diferent.
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"macros": [
{
"macro": "{$MY_MACRO}",
"value": "new_value"
}
]
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10086"
]
},
"id": 1
}Actualitzar les plantilles enllaçades
Desenllaça (sense esborrar) totes les plantilles de la plantilla donada i n'hi enllaça una de diferent.
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"templates": [
{
"templateid": "10087"
}
]
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10086"
]
},
"id": 1
}Neteja de les plantilles enllaçades amb plantilles
Desenllaça i neteja la plantilla donada d'una plantilla enllaçada específica.
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"templates_clear": [
{
"templateid": "10087"
}
]
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10086"
]
},
"id": 1
}Font
CTemplate::update() in ui/include/classes/api/services/CTemplate.php.