[comment]: # ({de78f971-2ea30393}) # discoveryruleprototype.get [comment]: # ({/de78f971-2ea30393}) [comment]: # ({402b74ae-2a4a3845}) ### Descrição `integer/array discoveryruleprototype.get(object parameters)` O método permite recuperar protótipos de regra de LLD de acordo com os parâmetros informados. ::: noteclassic Este método está disponível para usuários de qualquer tipo. As permissões para chamar o método podem ser revogadas nas configurações de função de usuário. Consulte [Funções de usuário](/manual/web_interface/frontend_sections/users/user_roles) para obter mais informações. ::: [comment]: # ({/402b74ae-2a4a3845}) [comment]: # ({54e078c5-ef542c37}) ### Parâmetros `(object)` Parâmetros que definem a saída desejada. O método suporta os seguintes parâmetros. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |itemids|ID/array|Retorna apenas protótipos de regra LLD com os IDs informados.| |groupids|ID/array|Retorna apenas protótipos de regra LLD que pertencem aos hosts dos grupos informados.| |hostids|ID/array|Retorna apenas protótipos de regra LLD que pertencem aos hosts informados.| |inherited|boolean|Se definido como `true`, retorna apenas protótipos de regra LLD herdados de um template.| |interfaceids|ID/array|Retorna apenas protótipos de regra LLD que usam as interfaces de host informadas.| |monitored|boolean|Se definido como `true`, retorna apenas protótipos de regra LLD habilitados que pertencem a hosts monitorados.| |templated|boolean|Se definido como `true`, retorna apenas protótipos de regra LLD que pertencem a templates.| |templateids|ID/array|Retorna apenas protótipos de regra LLD que pertencem aos templates informados.| |selectDiscoveryRule|query|Retorna uma propriedade [`discoveryRule`](/manual/api/reference/discoveryrule/object) com a regra LLD pai do protótipo de regra LLD.| |selectDiscoveryRulePrototype|query|Retorna uma propriedade [`discoveryRulePrototype`](/manual/api/reference/discoveryruleprototype/object) com o protótipo de regra LLD pai do protótipo de regra LLD.| |selectDiscoveryRulePrototypes|query|Retorna uma propriedade [`discoveryRulePrototypes`](/manual/api/reference/discoveryruleprototype/object) com protótipos de regra LLD filhos que pertencem ao protótipo de regra LLD.

Suporta `count`.| |selectFilter|query|Retorna uma propriedade [`filter`](/manual/api/reference/discoveryruleprototype/object#lld-rule-prototype-filter) com os dados do filtro usado pelo protótipo de regra LLD.| |selectGraphs|query|Retorna uma propriedade [`graphs`](/manual/api/reference/graph/object) com protótipos de gráfico que pertencem ao protótipo de regra LLD.

Suporta `count`.| |selectHostPrototypes|query|Retorna uma propriedade [`hostPrototypes`](/manual/api/reference/hostprototype/object) com protótipos de host que pertencem ao protótipo de regra LLD.

Suporta `count`.| |selectHosts|query|Retorna uma propriedade [`hosts`](/manual/api/reference/host/object) com uma matriz de hosts aos quais o protótipo de regra LLD pertence.| |selectItems|query|Retorna uma propriedade [`items`](/manual/api/reference/item/object) com protótipos de item que pertencem ao protótipo de regra LLD.

Suporta `count`.| |selectTriggers|query|Retorna uma propriedade [`triggers`](/manual/api/reference/trigger/object) com protótipos de trigger que pertencem ao protótipo de regra LLD.

Suporta `count`.| |selectLLDMacroPaths|query|Retorna uma propriedade [`lld_macro_paths`](/manual/api/reference/discoveryruleprototype/object#lld-macro-path) com uma lista de macros LLD e caminhos para os valores atribuídos a cada macro correspondente.| |selectPreprocessing|query|Retorna uma propriedade [`preprocessing`](/manual/api/reference/discoveryruleprototype/object#lld-rule-prototype-preprocessing) com as opções de pré-processamento do protótipo de regra LLD.| |selectOverrides|query|Retorna uma propriedade [`lld_rule_overrides`](/manual/api/reference/discoveryruleprototype/object#lld-rule-prototype-overrides) com uma lista de filtros, condições e operações de substituição executadas em objetos de protótipo.| |filter|object|Retorna apenas os resultados que correspondem exatamente ao filtro informado.

Aceita um objeto, em que as chaves são nomes de propriedades e os valores são um único valor ou uma matriz de valores para correspondência.

Não suporta propriedades do tipo de dados `text` [data type](/manual/api/reference_commentary#data-types).

Suporta propriedades adicionais:
`host` - nome técnico do host ao qual o protótipo de regra LLD pertence.| |limitSelects|integer|Limita o número de registros retornados por subconsultas.

Aplica-se às seguintes subconsultas: `selectItems`, `selectGraphs`, `selectTriggers`.| |sortfield|string/array|Classifica o resultado pelas propriedades informadas.

Valores possíveis: `itemid`, `name`, `key_`, `delay`, `type`, `status`.| |countOutput|boolean|Esses parâmetros são descritos no [reference commentary](/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]: # ({/54e078c5-ef542c37}) [comment]: # ({7223bab1-8b420463}) ### Valores de retorno `(integer/array)` Retorna um dos seguintes: - um array de objetos; - a contagem dos objetos recuperados, se o parâmetro `countOutput` tiver sido usado. [comment]: # ({/7223bab1-8b420463}) [comment]: # ({b41637d2-688543cd}) ### Exemplos [comment]: # ({/b41637d2-688543cd}) [comment]: # ({8717c31a-454ae381}) #### Recuperando protótipos de regras de descoberta de um host Recupere todos os protótipos de regras de descoberta para um ID de host específico. [Requisição](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "discoveryruleprototype.get", "params": { "hostids": "10084" }, "id": 1 } ``` [comment]: # ({/8717c31a-454ae381}) [comment]: # ({7789e5ca-8ebdd835}) Resposta: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "47253", "type": "23", "snmp_oid": "", "hostid": "10084", "name": "Descobrir tablespaces para {#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", "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]: # ({/7789e5ca-8ebdd835}) [comment]: # ({aacb1673-4de7e4ef}) ### Veja também - [Protótipo de gráfico](/manual/api/reference/graphprototype/object#graph-prototype) - [Host](/manual/api/reference/host/object#host) - [Protótipo de item](/manual/api/reference/itemprototype/object#item-prototype) - [Filtro de protótipo de regra de LLD](object#lld-rule-prototype-filter) - [Protótipo de trigger](/manual/api/reference/triggerprototype/object#trigger-prototype) [comment]: # ({/aacb1673-4de7e4ef}) [comment]: # ({28b25723-8d71dafa}) ### Source CDiscoveryRulePrototype::get() em *ui/include/classes/api/services/CDiscoveryRulePrototype.php*. [comment]: # ({/28b25723-8d71dafa})