Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

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 Admin y Super admin. Los permisos para llamar al método pueden ser revocados en la configuración de roles de usuario. Consulte Roles de usuario para más información.

Parámetros

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

El método acepta los siguientes parámetros.

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

Las plantillas deben tener definida únicamente la propiedad templateid.

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

Los grupos de plantillas deben tener definida únicamente la propiedad groupid.
macros objeto/array Macros de usuario para reemplazar todas las macros de usuario actuales en las plantillas indicadas.
templates_clear objeto/array Plantillas para desvincular y limpiar de las plantillas indicadas.

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

Las plantillas deben tener definida únicamente la propiedad templateid.

Valores de retorno

(object) Devuelve un objeto que contiene los IDs de las plantillas actualizadas bajo la propiedad templateids.

Ejemplos

Desvincular una plantilla

Desvincular y limpiar la plantilla "10091" de las plantillas indicadas.

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
       }

Reemplazar macros de usuario

Reemplazar todas las macros de usuario por la macro de usuario indicada 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": "Tiempo de espera tras el cual el agente se considera no disponible. Solo funciona para agentes accesibles desde el servidor/proxy Zabbix (modo pasivo)."
                   }
               ]
           },
           "id": 1
       }

Respuesta:

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

Véase también

Fuente

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