Esta es una traducción de la página de documentación original en español. Ayúdanos a mejorarla.

trigger.update

Descripción

object trigger.update(object/array triggers)

Este método permite actualizar los iniciadores 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 del iniciador que se actualizarán.

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

Además de las propiedades estándar de [iniciador] (object#trigger) el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
dependencies matriz Iniciadores de los que depende el iniciador.

Los iniciadores deben tener definida la propiedad triggerid.
tags matriz Etiquetas. del iniciador

La expresión del iniciador debe darse en su forma expandida.

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID de los iniciadores actualizados bajo la propiedad triggerids.

Ejemplos

Enabling a trigger

Enable a trigger, that is, set its status to 0.

Request:

{
           "jsonrpc": "2.0",
           "method": "trigger.update",
           "params": {
               "triggerid": "13938",
               "status": 0
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "triggerids": [
                   "13938"
               ]
           },
           "id": 1
       }

Replacing triggers tags

Replace tags for trigger.

Request:

{
           "jsonrpc": "2.0",
           "method": "trigger.update",
           "params": {
               "triggerid": "13938",
               "tags": [
                   {
                       "tag": "service",
                       "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"
                   },
                   {
                       "tag": "error",
                       "value": ""
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "triggerids": [
                   "13938"
               ]
           },
           "id": 1
       }

Ver también

Fuente

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