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

Habilitar un iniciador

Habilite un iniciador, es decir, establezca su estado en "0".

Solicitud:

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

Respuesta:

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

Reemplazo de etiquetas del iniciador

Reemplace las etiquetas del iniciador.

Solicitud:

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

Respuesta:

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

Reemplazo de dependencias

Reemplace las dependencias para el iniciador.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "trigger.update",
           "params": {
               "triggerid": "22713",
               "dependencies": [
                   {
                       "triggerid": "22712"
                   },
                   {
                       "triggerid": "22772"
                   }
               ]
           },
           "id": 1
       }

Respuesta:

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

Fuente

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