[comment]: # ({de78f971-2ea30393}) # discoveryruleprototype.get [comment]: # ({/de78f971-2ea30393}) [comment]: # ({b94513d6-2a4a3845}) ### Description `integer/array discoveryruleprototype.get(object parameters)` La méthode permet de récupérer les prototypes de règles LLD selon les paramètres fournis. ::: noteclassic Cette méthode est disponible pour les utilisateurs de tout type. Les autorisations d’appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Voir [User roles](/manual/web_interface/frontend_sections/users/user_roles) pour plus d’informations. ::: [comment]: # ({/b94513d6-2a4a3845}) [comment]: # ({18ba1319-ef542c37}) ### Paramètres `(object)` Paramètres définissant la sortie souhaitée. La méthode prend en charge les paramètres suivants. |Paramètre|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |discoveryids|ID/array|Retourner uniquement les prototypes de règle LLD qui appartiennent aux règles LLD ou aux prototypes de règle LLD indiqués.| |itemids|ID/array|Retourner uniquement les prototypes de règle LLD avec les ID indiqués.| |groupids|ID/array|Retourner uniquement les prototypes de règle LLD qui appartiennent aux hôtes des groupes indiqués.| |hostids|ID/array|Retourner uniquement les prototypes de règle LLD qui appartiennent aux hôtes indiqués.| |inherited|boolean|Si défini sur `true`, retourner uniquement les prototypes de règle LLD hérités d'un modèle.| |interfaceids|ID/array|Retourner uniquement les prototypes de règle LLD qui utilisent les interfaces d'hôte indiquées.| |monitored|boolean|Si défini sur `true`, retourner uniquement les prototypes de règle LLD activés qui appartiennent à des hôtes supervisés.| |templated|boolean|Si défini sur `true`, retourner uniquement les prototypes de règle LLD qui appartiennent à des modèles.| |templateids|ID/array|Retourner uniquement les prototypes de règle LLD qui appartiennent aux modèles indiqués.| |selectDiscoveryRule|query|Retourner une propriété [`discoveryRule`](/manual/api/reference/discoveryrule/object) avec la règle LLD parente du prototype de règle LLD.
Une réponse vide sera renvoyée si le parent est un prototype de règle de découverte.| |selectDiscoveryRulePrototype|query|Retourner une propriété [`discoveryRulePrototype`](/manual/api/reference/discoveryruleprototype/object) avec le prototype de règle LLD parent du prototype de règle LLD.
Une réponse vide sera renvoyée si le parent est une règle de découverte (et non un prototype).| |selectDiscoveryRulePrototypes|query|Retourner une propriété [`discoveryRulePrototypes`](/manual/api/reference/discoveryruleprototype/object) avec les prototypes de règle LLD enfants qui appartiennent au prototype de règle LLD.

Prend en charge `count`.| |selectFilter|query|Retourner une propriété [`filter`](/manual/api/reference/discoveryruleprototype/object#lld-rule-prototype-filter) avec les données du filtre utilisé par le prototype de règle LLD.| |selectGraphs|query|Retourne une propriété [`graphs`](/manual/api/reference/graph/object) avec les prototypes de graphique qui appartiennent au prototype de règle LLD.

Prend en charge `count`.| |selectHostPrototypes|query|Retourner une propriété [`hostPrototypes`](/manual/api/reference/hostprototype/object) avec les prototypes d'hôte qui appartiennent au prototype de règle LLD.

Prend en charge `count`.| |selectHosts|query|Retourner une propriété [`hosts`](/manual/api/reference/host/object) avec un tableau d'hôtes auxquels appartient le prototype de règle LLD.| |selectItems|query|Retourner une propriété [`items`](/manual/api/reference/item/object) avec les prototypes d'élément qui appartiennent au prototype de règle LLD.

Prend en charge `count`.| |selectTriggers|query|Retourner une propriété [`triggers`](/manual/api/reference/trigger/object) avec les prototypes de déclencheur qui appartiennent au prototype de règle LLD.

Prend en charge `count`.| |selectLLDMacroPaths|query|Retourner une propriété [`lld_macro_paths`](/manual/api/reference/discoveryruleprototype/object#lld-macro-path) avec une liste de macros LLD et les chemins vers les valeurs attribuées à chaque macro correspondante.| |selectPreprocessing|query|Retourner une propriété [`preprocessing`](/manual/api/reference/discoveryruleprototype/object#lld-rule-prototype-preprocessing) avec les options de prétraitement du prototype de règle LLD.| |selectOverrides|query|Retourner une propriété [`lld_rule_overrides`](/manual/api/reference/discoveryruleprototype/object#lld-rule-prototype-overrides) avec une liste de filtres de substitution, de conditions et d'opérations exécutées sur les objets prototypes.| |filter|object|Retourner uniquement les résultats qui correspondent exactement au filtre indiqué.

Accepte un objet où les clés sont des noms de propriété et les valeurs sont soit une valeur unique, soit un tableau de valeurs à faire correspondre.

Ne prend pas en charge les propriétés de type de données `text` [data type](/manual/api/reference_commentary#data-types).

Prend en charge des propriétés supplémentaires :
`host` - nom technique de l'hôte auquel appartient le prototype de règle LLD.| |limitSelects|integer|Limite le nombre d'enregistrements renvoyés par les sous-sélections.

S'applique aux sous-sélections suivantes : `selectItems`, `selectGraphs`, `selectTriggers`.| |sortfield|string/array|Trier le résultat selon les propriétés indiquées.

Valeurs possibles : `itemid`, `name`, `key_`, `delay`, `type`, `status`.| |countOutput|boolean|Ces paramètres sont décrits dans le [commentaire de référence](/manual/api/reference_commentary#common-get-method-parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| [comment]: # ({/18ba1319-ef542c37}) [comment]: # ({57bc51fd-8b420463}) ### Valeurs de retour `(integer/array)` renvoie soit : - un tableau d’objets ; - le nombre d’objets récupérés, si le paramètre `countOutput` a été utilisé. [comment]: # ({/57bc51fd-8b420463}) [comment]: # ({b41637d2-688543cd}) ### Exemples [comment]: # ({/b41637d2-688543cd}) [comment]: # ({8717c31a-454ae381}) #### Récupération des prototypes de règles de découverte à partir d’un hôte Récupérez tous les prototypes de règles de découverte pour un ID d’hôte spécifique. [Requête](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryruleprototype.get", "params": { "hostids": "10084" }, "id": 1 } ``` [comment]: # ({/8717c31a-454ae381}) [comment]: # ({50c11189-8ebdd835}) Réponse : ```json { "jsonrpc": "2.0", "result": [ { "itemid": "47253", "type": "23", "snmp_oid": "", "hostid": "10084", "name": "Découvrir les tablespaces pour {#DB}", "key_": "db.tablespace.discovery[{#DB}]", "delay": "0", "history": "31d", "trends": "365d", "status": "0", "value_type": "4", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "3", "interfaceid": "0", "description": "", "inventory_link": "0", "lifetime": "7d", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "lifetime_type": "0", "enabled_lifetime_type": "2", "enabled_lifetime": "0", "parameters": [] } ], "id": 1 } ``` [comment]: # ({/50c11189-8ebdd835}) [comment]: # ({aacb1673-4de7e4ef}) ### Voir aussi - [Prototype de graphique](/manual/api/reference/graphprototype/object#graph-prototype) - [Hôte](/manual/api/reference/host/object#host) - [Prototype d'élément](/manual/api/reference/itemprototype/object#item-prototype) - [Filtre de prototype de règle LLD](object#lld-rule-prototype-filter) - [Prototype de déclencheur](/manual/api/reference/triggerprototype/object#trigger-prototype) [comment]: # ({/aacb1673-4de7e4ef}) [comment]: # ({406819f4-8d71dafa}) ### Source CDiscoveryRulePrototype::get() dans *ui/include/classes/api/services/CDiscoveryRulePrototype.php*. [comment]: # ({/406819f4-8d71dafa})