usermacro.create

Descrição

object usermacro.create(object/array hostMacros)

Este método permite criar novas macros de host.

Este método está disponível apenas para os tipos de usuário Admin e Super admin. As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Veja Funções de usuário para mais informações.

Parâmetros

(object/array) Macros de host a serem criadas.

O método aceita macros de host com as propriedades padrão de macro de host.

Valores de retorno

(object) Retorna um objeto contendo os IDs das macros de host criadas na propriedade hostmacroids. A ordem dos IDs retornados corresponde à ordem das macros de host passadas.

Exemplos

Criando uma macro de host

Crie uma macro de host "{$SNMP_COMMUNITY}" com o valor "public" no host "10198".

Requisição:

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

Resposta:

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

Fonte

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