[comment]: # translation:outdated

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

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

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

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

Questo metodo consente di creare nuove regole di discovery.

::: noteclassic
Questo metodo è disponibile solo per i tipi di utente *Admin* e *Super admin*.
Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente.
Per ulteriori informazioni, vedere [Ruoli utente](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(object/array)` Regole di discovery da creare.

Oltre alle [proprietà standard delle regole di
discovery](object#discovery-rule), il metodo accetta i seguenti
parametri.

|Parametro|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|dchecks|array|[Controlli di discovery](/manual/api/reference/dcheck/object) da creare per la regola di discovery.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio*|

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

[comment]: # ({8b5259e3-2eb6d0d5})
### Restituisce i valori

`(object)` Restituisce un oggetto contenente gli ID delle
regole di scoperta create sotto la proprietà `druleids`. L'ordine degli ID restituiti corrispondono all'ordine delle regole di rilevamento passate.

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

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

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

[comment]: # ({fd18072b-b03b87c1})
#### Creare una regola di individuazione

Creare una regola di individuazione per trovare le macchine che eseguono lo Zabbix agent nella
rete locale. La regola deve utilizzare un singolo controllo Zabbix agent sulla porta
10050.

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

```json
{
    "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
}
```

Risposta:

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

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

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

-   [Controllo di
    discovery](/manual/api/reference/dcheck/object#discovery-check)

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

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

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

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