discoveryruleprototype.get

Descrizione

integer/array discoveryruleprototype.get(object parameters)

Il metodo consente di recuperare i prototipi delle regole LLD in base ai parametri specificati.

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

Parametri

(object) Parametri che definiscono l'output desiderato.

Il metodo supporta i seguenti parametri.

Parameter Type Description
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 usano 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.
selectDiscoveryRulePrototype query Restituisce una proprietà discoveryRulePrototype con il prototipo di regola LLD padre del prototipo di regola LLD.
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 usato dal prototipo di regola LLD.
selectGraphs query Restituisce una proprietà graphs con i prototipi di grafici 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 le proprietà di tipo text data type.

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 nella reference commentary.
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:

  • 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": "Discover tablespaces for {#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
}

Vedi anche

Sorgente

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