template.massupdate

Descripció

object template.massupdate(object parameters)

Aquest mètode permet substituir o esborrar simultàniament els objectes associats i actualitzar les propietats sobre diverses 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) Paràmetres que contenen els identificadors dels models a actualitzar i les propietats a actualitzar.

El mètode accepta els paràmetres següents.

Paràmetre Tipus Descripció
templates object/array Plantilles per actualitzar.

Les plantilles han de tindre només la propietat templateid establerta.

Comportament de la propietat:
- obligatori
groups object/array Grups de plantilles per substituir els grups de plantilles actuals als quals pertanyen les plantilles.

Els grups de plantilles han de tindre la propietat groupid establerta.
macros object/array Macros d'usuari per substituir totes les macros d'usuari actuals en models determinats.
templates_clear object/array Plantilles per desenllaçar i esborrar les plantilles donades.

Les plantilles han de tindre només la propietat templateid establerta.
templates_link object/array Plantilles que substitueixen les plantilles enllaçades actualment.

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

Desenllaçar plantilles

Desenllaça i neteja la plantilla "10091" de les plantilles donades.

Petició:

{
           "jsonrpc": "2.0",
           "method": "template.massupdate",
           "params": {
               "templates": [
                   {
                       "templateid": "10085"
                   },
                   {
                       "templateid": "10086"
                   }
               ],
               "templates_clear": [
                   {
                       "templateid": "10091"
                   }
               ]
           },
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "result": {
               "templateids": [
                   "10085",
                   "10086"
               ]
           },
           "id": 1
       }

Reemplaçar macros d'usuari

Substitueix totes les macros d'usuari per la macro donada a diverses plantilles.

Petició:

{
           "jsonrpc": "2.0",
           "method": "template.massupdate",
           "params": {
               "templates": [
                   {
                       "templateid": "10074"
                   },
                   {
                       "templateid": "10075"
                   },
                   {
                       "templateid": "10076"
                   },
                   {
                       "templateid": "10077"
                   }
               ],
               "macros": [
                   {
                       "macro": "{$AGENT.TIMEOUT}",
                       "value": "5m",
                       "description": "Timeout after which agent is considered unavailable. Works only for agents reachable from Zabbix server/proxy (passive mode)."
                   }
               ]
           },
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "result": {
               "templateids": [
                   "10074",
                   "10075",
                   "10076",
                   "10077"
               ]
           },
           "id": 1
       }

Veieu també

Font

CTemplate::massUpdate() in ui/include/classes/api/services/CTemplate.php.