[comment]: # translation:outdated

[comment]: # ({0a1af107-0a1af107})
## drule.update

[comment]: # ({/0a1af107-0a1af107})

[comment]: # ({26e94e9f-ac17a9e2})
### Descrição

`object drule.update(object/array discoveryRules)`

Este método permite atualizar as regras de descoberta existentes.

::: noteclassic
Este método está disponível apenas para *Admin* e *Superadministrador*
tipos de usuário. As permissões para chamar o método podem ser revogadas na função de usuário
definições. Veja [Usuário
funções](/manual/web_interface/frontend_sections/administration/user_roles)
Para maiores informações.
:::

[comment]: # ({/26e94e9f-ac17a9e2})

[comment]: # ({c26c6157-0dd5b0c8})
### Parâmetros

`(object/array)` Propriedades da regra de descoberta a serem atualizadas.

A propriedade `druleid` deve ser definida para cada regra de descoberta, todas
outras propriedades são opcionais. Somente as propriedades passadas serão
atualizado, todos os outros permanecerão inalterados.

Além da [regra de descoberta padrão
properties](object#discovery_rule), o método aceita o seguinte
parâmetros.

|Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição|
|---------|----------------------------------- ------------|-----------|
|dchecks|array|Discovery [checks](/manual/api/reference/dcheck/object) para substituir as verificações existentes.|

[comment]: # ({/c26c6157-0dd5b0c8})

[comment]: # ({495f933e-495f933e})
### Valores de retorno

`(object)` Retorna um objeto contendo os IDs da descoberta atualizada
regras sob a propriedade `druleids`.

[comment]: # ({/495f933e-495f933e})

[comment]: # ({b41637d2-b41637d2})
### Exemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({e1d007ec-11119b8e})
#### Alterar o intervalo de IP de uma regra de descoberta

Altere o intervalo de IP de uma regra de descoberta para "192.168.2.1-255".

Solicitação:

``` {.java}
{
    "jsonrpc": "2.0",
    "método": "drule.update",
    "parâmetros": {
        "druleid": "6",
        "iprange": "192.168.2.1-255"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Resposta:

``` {.java}
{
    "jsonrpc": "2.0",
    "resultado": {
        "druleidas": [
            "6"
        ]
    },
    "id": 1
}
```

[comment]: # ({/e1d007ec-11119b8e})

[comment]: # ({54664cce-54664cce})
### Veja também

-   [Descoberta
    check](/manual/api/reference/dcheck/object#discovery_check)

[comment]: # ({/54664cce-54664cce})

[comment]: # ({d9252108-d9252108})
### Fonte

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

[comment]: # ({/d9252108-d9252108})