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 objeto/matriz Plantillas a actualizar.

Las plantillas deben tener la propiedad templateid definida.

Comportamiento del parámetro:
- obligatorio
groups objeto/matriz Grupos de plantillas para reemplazar los grupos de plantillas actuales a los que pertenecen las plantillas.

Los grupos de plantillas deben tener la propiedad groupid definido.
macros objeto/matriz Macros de usuario para reemplazar todas las macros de usuario actuales en las plantillas dadas.
templates_clear objeto/matriz Plantillas para desvincular y borrar de las plantillas dadas.

Las plantillas deben tener definida la propiedad templateid.
templates_link objeto/matriz Plantillas para reemplazar las plantillas actualmente vinculadas.

Las plantillas deben tener definida la propiedad templateid.

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.