drule.create

Descrição

object drule.create(object/array discoveryRules)

Este método permite criar novas regras de descoberta.

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 de usuário. Veja Funções de usuário para mais informações.

Parâmetros

(object/array) Regras de descoberta a serem criadas.

Além das propriedades padrão da regra de descoberta, o método aceita os seguintes parâmetros.

Parâmetro Tipo Descrição
dchecks array Verificações de descoberta a serem criadas para a regra de descoberta.

Comportamento do parâmetro:
- obrigatório

Valores de retorno

(object) Retorna um objeto contendo os IDs das regras de descoberta criadas na propriedade druleids. A ordem dos IDs retornados corresponde à ordem das regras de descoberta passadas.

Exemplos

Criar uma regra de descoberta

Crie uma regra de descoberta para encontrar máquinas executando o agent Zabbix na rede local. A regra deve usar uma única verificação de agent Zabbix na porta 10050.

Requisição:

{
    "jsonrpc": "2.0",
    "method": "drule.create",
    "params": {
        "name": "Zabbix agent discovery",
        "iprange": "192.168.1.1-255",
        "concurrency_max": "10",
        "dchecks": [
            {
                "type": "9",
                "key_": "system.uname",
                "ports": "10050",
                "uniq": "0"
            }
        ]
    },
    "id": 1
}

Resposta:

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

Veja também

Origem

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