discoveryruleprototype.get

Descripción

integer/array discoveryruleprototype.get(object parameters)

El método permite recuperar prototipos de reglas LLD según los parámetros proporcionados.

Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método pueden revocarse en la configuración de roles de usuario. Consulte Roles de usuario para obtener más información.

Parámetros

(object) Parámetros que definen la salida deseada.

El método admite los siguientes parámetros.

Parameter Type Description
itemids ID/array Devuelve solo prototipos de reglas LLD con los IDs dados.
groupids ID/array Devuelve solo prototipos de reglas LLD que pertenecen a los hosts de los grupos dados.
hostids ID/array Devuelve solo prototipos de reglas LLD que pertenecen a los hosts dados.
inherited boolean Si se establece en true, devuelve solo prototipos de reglas LLD heredados de un template.
interfaceids ID/array Devuelve solo prototipos de reglas LLD que usan las interfaces de host dadas.
monitored boolean Si se establece en true, devuelve solo prototipos de reglas LLD habilitados que pertenecen a hosts monitorizados.
templated boolean Si se establece en true, devuelve solo prototipos de reglas LLD que pertenecen a templates.
templateids ID/array Devuelve solo prototipos de reglas LLD que pertenecen a los templates dados.
selectDiscoveryRule query Devuelve una propiedad discoveryRule con la regla LLD principal del prototipo de regla LLD.
selectDiscoveryRulePrototype query Devuelve una propiedad discoveryRulePrototype con el prototipo de regla LLD principal del prototipo de regla LLD.
selectDiscoveryRulePrototypes query Devuelve una propiedad discoveryRulePrototypes con prototipos de reglas LLD secundarias que pertenecen al prototipo de regla LLD.

Admite count.
selectFilter query Devuelve una propiedad filter con los datos del filtro usado por el prototipo de regla LLD.
selectGraphs query Devuelve una propiedad graphs con prototipos de gráficos que pertenecen al prototipo de regla LLD.

Admite count.
selectHostPrototypes query Devuelve una propiedad hostPrototypes con prototipos de host que pertenecen al prototipo de regla LLD.

Admite count.
selectHosts query Devuelve una propiedad hosts con un array de hosts al que pertenece el prototipo de regla LLD.
selectItems query Devuelve una propiedad items con prototipos de item que pertenecen al prototipo de regla LLD.

Admite count.
selectTriggers query Devuelve una propiedad triggers con prototipos de trigger que pertenecen al prototipo de regla LLD.

Admite count.
selectLLDMacroPaths query Devuelve una propiedad lld_macro_paths con una lista de macros LLD y rutas a los valores asignados a cada macro correspondiente.
selectPreprocessing query Devuelve una propiedad preprocessing con las opciones de preprocesamiento del prototipo de regla LLD.
selectOverrides query Devuelve una propiedad lld_rule_overrides con una lista de filtros, condiciones y operaciones de anulación que se realizan sobre los objetos prototipo.
filter object Devuelve solo los resultados que coinciden exactamente con el filtro dado.

Acepta un objeto, donde las claves son nombres de propiedades y los valores son un único valor o un array de valores con los que comparar.

No admite propiedades de tipo de datos text data type.

Admite propiedades adicionales:
host - nombre técnico del host al que pertenece el prototipo de regla LLD.
limitSelects integer Limita el número de registros devueltos por las subconsultas.

Se aplica a las siguientes subconsultas: selectItems, selectGraphs, selectTriggers.
sortfield string/array Ordena el resultado por las propiedades dadas.

Valores posibles: itemid, name, key_, delay, type, status.
countOutput boolean Estos parámetros se describen en el comentario de referencia.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valores de retorno

(integer/array) Devuelve cualquiera de los siguientes:

  • un array de objetos;
  • el número de objetos recuperados, si se ha utilizado el parámetro countOutput.

Ejemplos

Recuperar prototipos de reglas de descubrimiento de un equipo

Recupera todos los prototipos de reglas de descubrimiento para un ID de equipo específico.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "discoveryruleprototype.get",
    "params": {
        "hostids": "10084"
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "itemid": "47253",
            "type": "23",
            "snmp_oid": "",
            "hostid": "10084",
            "name": "Descubrir 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
}

Ver también

Source

CDiscoveryRulePrototype::get() en ui/include/classes/api/services/CDiscoveryRulePrototype.php.