discoveryruleprototype.get

Descrizione

integer/array discoveryruleprototype.get(object parameters)

Questo metodo consente di recuperare i prototipi di regola LLD in base ai parametri specificati.

Questo metodo è disponibile per utenti di qualsiasi tipo. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Per ulteriori informazioni, vedere User roles.

Parametri

(object) Parametri che definiscono l'output desiderato.

Il metodo supporta i seguenti parametri.

Parametro Type Descrizione
discoveryids ID/array Restituisce solo i prototipi di regole LLD che appartengono alle regole LLD o ai prototipi di regole LLD specificati.
itemids ID/array Restituisce solo i prototipi di regole LLD con gli ID specificati.
groupids ID/array Restituisce solo i prototipi di regole LLD che appartengono agli host dei gruppi specificati.
hostids ID/array Restituisce solo i prototipi di regole LLD che appartengono agli host specificati.
inherited boolean Se impostato su true, restituisce solo i prototipi di regole LLD ereditati da un template.
interfaceids ID/array Restituisce solo i prototipi di regole LLD che utilizzano le interfacce host specificate.
monitored boolean Se impostato su true, restituisce solo i prototipi di regole LLD abilitati che appartengono a host monitorati.
templated boolean Se impostato su true, restituisce solo i prototipi di regole LLD che appartengono ai template.
templateids ID/array Restituisce solo i prototipi di regole LLD che appartengono ai template specificati.
selectDiscoveryRule query Restituisce una proprietà discoveryRule con la regola LLD padre del prototipo di regola LLD.
Restituirà una risposta vuota se il padre è un prototipo di regola di discovery.
selectDiscoveryRulePrototype query Restituisce una proprietà discoveryRulePrototype con il prototipo di regola LLD padre del prototipo di regola LLD.
Restituirà una risposta vuota se il padre è una regola di discovery (non un prototipo).
selectDiscoveryRulePrototypes query Restituisce una proprietà discoveryRulePrototypes con i prototipi di regole LLD figli che appartengono al prototipo di regola LLD.

Supporta count.
selectFilter query Restituisce una proprietà filter con i dati del filtro utilizzato dal prototipo di regola LLD.
selectGraphs query Restituisce una proprietà graphs con i prototipi di grafico che appartengono al prototipo di regola LLD.

Supporta count.
selectHostPrototypes query Restituisce una proprietà hostPrototypes con i prototipi di host che appartengono al prototipo di regola LLD.

Supporta count.
selectHosts query Restituisce una proprietà hosts con un array di host a cui appartiene il prototipo di regola LLD.
selectItems query Restituisce una proprietà items con i prototipi di item che appartengono al prototipo di regola LLD.

Supporta count.
selectTriggers query Restituisce una proprietà triggers con i prototipi di trigger che appartengono al prototipo di regola LLD.

Supporta count.
selectLLDMacroPaths query Restituisce una proprietà lld_macro_paths con un elenco di macro LLD e dei percorsi ai valori assegnati a ciascuna macro corrispondente.
selectPreprocessing query Restituisce una proprietà preprocessing con le opzioni di preprocessing del prototipo di regola LLD.
selectOverrides query Restituisce una proprietà lld_rule_overrides con un elenco di filtri di override, condizioni e operazioni eseguite sugli oggetti prototipo.
filter object Restituisce solo i risultati che corrispondono esattamente al filtro specificato.

Accetta un oggetto in cui le chiavi sono nomi di proprietà e i valori sono un singolo valore oppure un array di valori da confrontare.

Non supporta proprietà del tipo di dati text.

Supporta proprietà aggiuntive:
host - nome tecnico dell'host a cui appartiene il prototipo di regola LLD.
limitSelects integer Limita il numero di record restituiti dalle sotto-selezioni.

Si applica alle seguenti sotto-selezioni: selectItems, selectGraphs, selectTriggers.
sortfield string/array Ordina il risultato in base alle proprietà specificate.

Valori possibili: itemid, name, key_, delay, type, status.
countOutput boolean Questi parametri sono descritti nel commento di riferimento.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valori restituiti

(integer/array) restituisce uno dei seguenti valori:

  • un array di oggetti;
  • il numero di oggetti recuperati, se è stato utilizzato il parametro countOutput.

Esempi

Recupero dei prototipi di regola di discovery da un host

Recupera tutti i prototipi di regola di discovery per uno specifico ID host.

Request:

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

Risposta:

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

Vedi anche

Sorgente

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