[comment]: # ({8102730f-8102730f})
# drule.create

[comment]: # ({/8102730f-8102730f})

[comment]: # ({e51fc566-9e7d03a2})
### Descripción

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

Este método permite crear nuevas reglas de descubrimiento.

::: noteclassic
Este método solo está disponible para los tipos de usuario *Admin* y *Super admin*. Los permisos para llamar al método pueden ser revocados en la configuración de roles de usuario. Consulte [Roles de usuario](/manual/web_interface/frontend_sections/users/user_roles) para obtener más información.
:::

[comment]: # ({/e51fc566-9e7d03a2})

[comment]: # ({b0b514c2-7afdb3b3})
### Parámetros

`(objeto/array)` Reglas de descubrimiento a crear.

Además de las [propiedades estándar de las reglas de descubrimiento](object#discovery-rule), el método acepta los siguientes parámetros.

|Parámetro|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|dchecks|array|[Comprobaciones de descubrimiento](/manual/api/reference/dcheck/object) a crear para la regla de descubrimiento.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio*|

[comment]: # ({/b0b514c2-7afdb3b3})

[comment]: # ({8b5259e3-2eb6d0d5})
### Valores de retorno

`(object)` Devuelve un objeto que contiene los IDs de las reglas de descubrimiento creadas bajo la propiedad `druleids`. El orden de los IDs devueltos coincide con el orden de las reglas de descubrimiento enviadas.

[comment]: # ({/8b5259e3-2eb6d0d5})

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

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

[comment]: # ({fd18072b-b03b87c1})
#### Crear una regla de descubrimiento

Cree una regla de descubrimiento para encontrar máquinas que ejecutan el agente de Zabbix en la
red local. La regla debe usar una única comprobación de agente de Zabbix en el puerto
10050.

[Solicitud](/manual/api#performing-requests):

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

Respuesta:

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

[comment]: # ({/fd18072b-b03b87c1})

[comment]: # ({396b4d4f-54664cce})
### Ver también

-   [Comprobación de descubrimiento](/manual/api/reference/dcheck/object#discovery-check)

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

[comment]: # ({1333854c-1333854c})
### Fuente

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

[comment]: # ({/1333854c-1333854c})