usermacro.update

Descrição

object usermacro.update(object/array hostMacros)

Este método permite atualizar macros de host existentes.

Parâmetros

(object/array) Propriedades de macro de host a serem atualizadas.

A propriedade hostmacroid deve ser definida para cada macro de host, todas as outras propriedades são opcionais. Somente as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.

Valores de retorno

(object) Retorna um objeto contendo os IDs das macros de host atualizadas sob a propriedade hostmacroids.

Exemplos

Alterando o valor de uma macro de host

Altere o valor de uma macro de host para "public".

Requisição:

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

Resposta:

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

Alterar o valor da macro que foi criada por regra de descoberta

Converter a macro "automática" criada pela regra de descoberta para "manual" e alterar seu valor para "novo-valor".

Requisição:

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

Resposta:

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

Origem

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