Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Únase a nuestro proyecto de traducción y ayude a traducir la documentación de Zabbix a su lengua materna.

template.update

Descripción

object template.update(object/array templates)

Este método permite actualizar las plantillas existentes.

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/matriz) Propiedades de la plantilla que se actualizarán.

La propiedad templateid debe definirse para cada plantilla, todas las demás propiedades son opcionales. Sólo se actualizarán las propiedades dadas, todas las demás permanecerán sin cambios.

Además de las propiedades estándar de plantilla, el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
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.
tags objeto/matriz Etiquetas de plantilla para reemplazar las etiquetas de plantilla actuales.
macros objeto/matriz Macros de usuario para reemplazar las macros de usuario actuales en las plantillas dadas.
templates objeto/matriz Plantillas para reemplazar las plantillas actualmente vinculadas. Las plantillas que no se pasan solo se desvinculan.

Las plantillas deben tener definida la propiedad templateid.
templates_clear objeto/matriz Plantillas para desvincular y borrar de las plantillas dadas.

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

Cambiar el nombre de una plantilla

Cambie el nombre de la plantilla a "Plantilla OS Linux".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "template.update",
           "params": {
               "templateid": "10086",
               "name": "Plantilla OS Linux"
           },
           "id": 1
       }

Respuesta:

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

Actualización de etiquetas de plantilla

Reemplace todas las etiquetas de plantilla por una nueva.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "template.update",
           "params": {
               "templateid": "10086",
               "tags": [
                   {
                       "tag": "Host name",
                       "value": "{HOST.NAME}"
                   }
               ]
           },
           "id": 1
       }

Respuesta:

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

Fuente

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