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

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

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

Valores de retorno

(object) Retorna um objeto contendo os IDs das macros de host criadas sob a 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() in ui/include/classes/api/services/CUserMacro.php.