discoveryruleprototype.get

Opis

integer/array discoveryruleprototype.get(object parameters)

Ta metoda umożliwia pobranie prototypów reguł LLD zgodnie z podanymi parametrami.

Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji można znaleźć w Rolach użytkowników.

Parametry

(object) Parametry definiujące żądane dane wyjściowe.

Metoda obsługuje następujące parametry.

Parametr Typ Opis
discoveryids ID/array Zwracaj tylko prototypy reguł LLD należące do podanych reguł LLD lub prototypów reguł LLD.
itemids ID/array Zwracaj tylko prototypy reguł LLD o podanych identyfikatorach.
groupids ID/array Zwracaj tylko prototypy reguł LLD należące do hostów z podanych grup.
hostids ID/array Zwracaj tylko prototypy reguł LLD należące do podanych hostów.
inherited boolean Jeśli ustawiono true, zwracaj tylko prototypy reguł LLD odziedziczone z szablonu.
interfaceids ID/array Zwracaj tylko prototypy reguł LLD używające podanych interfejsów hosta.
monitored boolean Jeśli ustawiono true, zwracaj tylko włączone prototypy reguł LLD należące do monitorowanych hostów.
templated boolean Jeśli ustawiono true, zwracaj tylko prototypy reguł LLD należące do szablonów.
templateids ID/array Zwracaj tylko prototypy reguł LLD należące do podanych szablonów.
selectDiscoveryRule query Zwracaj właściwość discoveryRule z nadrzędną regułą LLD prototypu reguły LLD.
Zwróci pustą odpowiedź, jeśli element nadrzędny jest prototypem reguły wykrywania.
selectDiscoveryRulePrototype query Zwracaj właściwość discoveryRulePrototype z nadrzędnym prototypem reguły LLD dla prototypu reguły LLD.
Zwróci pustą odpowiedź, jeśli element nadrzędny jest regułą wykrywania (nie prototypem).
selectDiscoveryRulePrototypes query Zwracaj właściwość discoveryRulePrototypes z podrzędnymi prototypami reguł LLD należącymi do prototypu reguły LLD.

Obsługuje count.
selectFilter query Zwracaj właściwość filter z danymi filtra używanego przez prototyp reguły LLD.
selectGraphs query Zwraca właściwość graphs z prototypami wykresów należącymi do prototypu reguły LLD.

Obsługuje count.
selectHostPrototypes query Zwracaj właściwość hostPrototypes z prototypami hostów należącymi do prototypu reguły LLD.

Obsługuje count.
selectHosts query Zwracaj właściwość hosts z tablicą hostów, do których należy prototyp reguły LLD.
selectItems query Zwracaj właściwość items z prototypami pozycji należącymi do prototypu reguły LLD.

Obsługuje count.
selectTriggers query Zwracaj właściwość triggers z prototypami wyzwalaczy należącymi do prototypu reguły LLD.

Obsługuje count.
selectLLDMacroPaths query Zwracaj właściwość lld_macro_paths z listą makr LLD i ścieżek do wartości przypisanych do każdego odpowiedniego makra.
selectPreprocessing query Zwracaj właściwość preprocessing z opcjami przetwarzania wstępnego prototypu reguły LLD.
selectOverrides query Zwracaj właściwość lld_rule_overrides z listą filtrów nadpisywania, warunków i operacji wykonywanych na obiektach prototypów.
filter object Zwracaj tylko te wyniki, które dokładnie odpowiadają podanemu filtrowi.

Akceptuje obiekt, w którym klucze są nazwami właściwości, a wartościami są pojedyncza wartość lub tablica wartości do dopasowania.

Nie obsługuje właściwości typu danych text data type.

Obsługuje dodatkowe właściwości:
host - nazwa techniczna hosta, do którego należy prototyp reguły LLD.
limitSelects integer Ogranicza liczbę rekordów zwracanych przez podzapytania.

Ma zastosowanie do następujących podzapytań: selectItems, selectGraphs, selectTriggers.
sortfield string/array Sortuj wynik według podanych właściwości.

Możliwe wartości: itemid, name, key_, delay, type, status.
countOutput boolean Te parametry opisano w komentarzu referencyjnym.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Zwracane wartości

(integer/array) zwraca:

  • tablicę obiektów;
  • liczbę pobranych obiektów, jeśli został użyty parametr countOutput.

Przykłady

Pobieranie prototypów reguł wykrywania z hosta

Pobierz wszystkie prototypy reguł wykrywania dla określonego ID hosta.

Żądanie:

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

Odpowiedź:

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

Zobacz także

Źródło

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