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.

usermacro.update

Descripción

object usermacro.update(object/array hostMacros)

Este método permite actualizar las macros de equipo 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 macro del equipo a ser actualizadas.

La propiedad hostmacroid debe definirse para cada macro de equipo, todas las otras propiedades son opcionales. Sólo las propiedades pasadas serán actualizadas, todas las demás permanecerán sin cambios.

Valores devueltos

(object) Devuelve un objeto que contiene los ID de las macros actualizadas bajo la propiedad hostmacrosids.

Ejemplos

Cambiar el valor de una macro de equipo

Cambie el valor de una macro de equipo a "public".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "usermacro.update",
           "params": {
               "hostmacroid": "1",
               "value": "public"
           },
           "id": 1
       }

Respuesta:

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

Cambiar el valor de la macro creada por la regla de descubrimiento

Convierta la macro "automática" creada en la regla de descubrimiento a "manual" y cambie su valor a "new-value".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "usermacro.update",
           "params": {
               "hostmacroid": "1",
               "value": "new-value",
               "automatic": "0"
           },
           "id": 1
       }

Respuesta:

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

Fuente

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