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

(object/array) Propiedades de macro de host que se van a actualizar.

La propiedad hostmacroid debe estar definida para cada macro de host, todas las demás propiedades son opcionales. Sólo se actualizarán las propiedades pasadas, 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.