usermacro.create

Descripción

object usermacro.create(object/array hostMacros)

Este método permite crear nuevos macros de host.

Este método solo está disponible para los tipos de usuario Admin y Super admin. Los permisos para llamar al método pueden revocarse en la configuración de roles de usuario. Consulte Roles de usuario para obtener más información.

Parámetros

(object/array) Macros de host a crear.

El método acepta macros de host con las propiedades estándar de las macros de host.

Valores de retorno

(object) Devuelve un objeto que contiene los IDs de las macros de equipo creadas bajo la propiedad hostmacroids. El orden de los IDs devueltos coincide con el orden de las macros de equipo enviadas.

Ejemplos

Creación de un macro de host

Cree un macro de host {$SNMP_COMMUNITY} con el valor "public" en el host "10198".

Request:

{
    "jsonrpc": "2.0",
    "method": "usermacro.create",
    "params": {
        "hostid": "10198",
        "macro": "{$SNMP_COMMUNITY}",
        "value": "public"
    },
    "id": 1
}

Respuesta:

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

Fuente

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