template.massupdate

Descripción

object template.massupdate(object parameters)

Este método permite reemplazar o eliminar simultáneamente objetos relacionados. y actualizar propiedades en múltiples plantillas.

Este método solo está disponible para los tipos de usuario Administrador y Superadministrador. Los permisos para llamar al método se pueden revocar en la configuración del rol de usuario. Ver Roles de usuario para obtener más información.

Parámetros

(objeto) Parámetros que contienen los ID de las plantillas para actualizar y los objetos para reemplazar por las plantillas.

El método acepta los siguientes parámetros.

Parámetro Tipo Descripción
templates object/array Plantillas a actualizar.

Las plantillas deben tener solo la propiedad templateid definida.

Comportamiento de parámetros:
- obligatorio
groups object/array Grupos de plantillas para reemplazar los grupos de plantillas actuales a los que pertenecen las plantillas.

Los grupos de plantillas deben tener solo el groupid propiedad definida.
macros object/array Macros de usuario para reemplazar todas las macros de usuario actuales en las plantillas dadas.
templates_clear object/array Plantillas para desvincular y borrar de las plantillas proporcionadas.

Las plantillas deben tener solo la propiedad templateid definida .
templates_link object/array 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 las plantillas actualizadas bajo la propiedad templateids.

Ejemplos

Desvincular una plantilla

Desvincule y borre la plantilla "10091" de las plantillas proporcionadas.

Solicitud:

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

Respuesta:

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

Reemplazo de macros de usuario

Reemplace todas las macros de usuario con la macro de usuario proporcionada en varias plantillas.

Solicitud:

{
           "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
       }

Respuesta:

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

Ver también

Fuente

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