triggerprototype.get

Apraksts

integer/array triggerprototype.get(object parameters)

Šī metode ļauj izgūt trigeru prototipus atbilstoši norādītajiem parametriem.

Šī metode ir pieejama jebkura tipa lietotājiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet User roles.

Parametri

(object) Parametri, kas nosaka vēlamo izvadi.

Metode atbalsta šādus parametrus.

Parameter Type Description
active flag Atgriezt tikai iespējotus trigeru prototipus, kas pieder uzraudzītiem hosts.
discoveryids ID/array Atgriezt tikai trigeru prototipus, kas pieder norādītajiem LLD noteikumiem.
functions string/array Atgriezt tikai trigerus, kuros tiek izmantotas norādītās funkcijas.

Atbalstīto funkciju sarakstu skatiet lapā Atbalstītās funkcijas.
group string Atgriezt tikai trigeru prototipus, kas pieder hosts vai veidnēm no hostu grupām vai veidņu grupām ar norādīto nosaukumu.
groupids ID/array Atgriezt tikai trigeru prototipus, kas pieder hosts vai veidnēm no norādītajām hostu grupām vai veidņu grupām.
host string Atgriezt tikai trigeru prototipus, kas pieder hosts ar norādīto nosaukumu.
hostids ID/array Atgriezt tikai trigeru prototipus, kas pieder norādītajiem hosts.
inherited boolean Ja iestatīts uz true, atgriezt tikai no veidnes mantotus trigeru prototipus.
maintenance boolean Ja iestatīts uz true, atgriezt tikai iespējotus trigeru prototipus, kas pieder hosts uzturēšanas režīmā.
min_severity integer Atgriezt tikai trigeru prototipus, kuru nopietnības līmenis ir lielāks vai vienāds ar norādīto nopietnības līmeni.
monitored flag Atgriezt tikai iespējotus trigeru prototipus, kas pieder uzraudzītiem hosts un satur tikai iespējotus vienumus.
templated boolean Ja iestatīts uz true, atgriezt tikai trigeru prototipus, kas pieder veidnēm.
templateids ID/array Atgriezt tikai trigeru prototipus, kas pieder norādītajām veidnēm.
triggerids ID/array Atgriezt tikai trigeru prototipus ar norādītajiem ID.
expandExpression flag Izvērst funkcijas un makro trigeru izteiksmē.
selectDependencies query Atgriezt trigeru prototipus un trigerus, no kuriem trigeru prototips ir atkarīgs, rekvizītā dependencies.
selectDiscoveryData query Atgriezt rekvizītu discoveryData ar trigeru prototipa atklāšanas objekta datiem. Trigeru prototipa atklāšanas objekts sasaista atklāto trigeru prototipu ar trigeru prototipu, no kura tas tika atklāts.

Tam ir šādi rekvizīti:
parent_triggerid - (ID) tā trigeru prototipa ID, no kura tika izveidots trigeru prototips;
status - (int) trigeru prototipa atklāšanas statuss:
0 - (noklusējums) trigeru prototips ir atklāts,
1 - trigeru prototips vairs nav atklāts;
ts_delete - (timestamp) laiks, kad vairs neatklātais trigeru prototips tiks dzēsts;
ts_disable - (timestamp) laiks, kad vairs neatklātais trigeru prototips tiks atspējots;
disable_source - (int) indikators, kas norāda, vai trigeru prototipu atspējoja LLD noteikums vai manuāli:
0 - (noklusējums) atspējots automātiski,
1 - atspējots ar LLD noteikumu.
selectDiscoveryRule query Atgriezt LLD noteikumu, kuram trigeru prototips pieder, rekvizītā discoveryRule.
selectDiscoveryRulePrototype query Atgriezt rekvizītu discoveryRulePrototype ar vecāka LLD noteikuma prototipu, kuram trigeru prototips pieder.
selectFunctions query Atgriezt trigeru prototipā izmantotās funkcijas rekvizītā functions.

Funkciju objekti attēlo trigeru izteiksmē izmantotās funkcijas, un tiem ir šādi rekvizīti:
functionid - (ID) funkcijas ID;
itemid - (ID) funkcijā izmantotā vienuma ID;
function - (string) funkcijas nosaukums;
parameter - (string) funkcijai nodotais parametrs. Atgrieztajā virknē vaicājuma parametrs tiek aizstāts ar simbolu $.
selectHostGroups query Atgriezt hostu grupas, kurām trigeru prototips pieder, rekvizītā hostgroups.
selectHosts query Atgriezt hosts, kuriem trigeru prototips pieder, rekvizītā hosts.
selectInheritedTags query Atgriezt rekvizītu inheritedTags ar tagiem, kas mantoti no veidnēm, saistītajām veidnēm un hosts, kā arī no vienumiem un vienumu prototipiem, uz kuriem ir atsauce trigeru vai atkopšanas izteiksmēs.
selectItems query Atgriezt trigeru prototipā izmantotos vienumus un vienumu prototipus rekvizītā items.
selectTags query Atgriezt trigeru prototipa tagus rekvizītā tags.
selectTemplateGroups query Atgriezt veidņu grupas, kurām trigeru prototips pieder, rekvizītā templategroups.
filter object Atgriezt tikai tos rezultātus, kas precīzi atbilst norādītajam filtram.

Pieņem objektu, kurā atslēgas ir rekvizītu nosaukumi, bet vērtības ir viena vērtība vai vērtību masīvs, ar ko veikt salīdzināšanu.

Neatbalsta text datu tipa rekvizītus.

Atbalsta papildu rekvizītus:
host - tā hosta tehniskais nosaukums, kuram trigeru prototips pieder;
hostid - tā hosta ID, kuram trigeru prototips pieder.
limitSelects integer Ierobežo apakšatlases atgriezto ierakstu skaitu.

Attiecas uz šādām apakšatlasēm:
selectHosts - rezultāti tiks kārtoti pēc host.
sortfield string/array Kārtot rezultātu pēc norādītajiem rekvizītiem.

Iespējamās vērtības: triggerid, description, status, priority, discovered.
countOutput boolean Šie parametri ir aprakstīti atsauces komentāros.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Atgrieztās vērtības

(integer/array) Atgriež vienu no šīm vērtībām:

  • objektu masīvu;
  • izgūto objektu skaitu, ja ir izmantots parametrs countOutput.

Piemēri

Iegūt trigeru prototipus no LLD kārtulas

Iegūstiet visus trigeru prototipus un to funkcijas no LLD kārtulas.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "triggerprototype.get",
    "params": {
        "output": "extend",
        "selectFunctions": "extend",
        "discoveryids": "22450"
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "triggerid": "13272",
            "expression": "{12598}<20",
            "description": "Brīvo inode skaits ir mazāks par 20% sējumā {#FSNAME}",
            "url": "",
            "status": "0",
            "value": "0",
            "priority": "2",
            "lastchange": "0",
            "comments": "",
            "error": "",
            "templateid": "0",
            "type": "0",
            "state": "0",
            "flags": "2",
            "recovery_mode": "0",
            "recovery_expression": "",
            "correlation_mode": "0",
            "correlation_tag": "",
            "manual_close": "0",
            "opdata": "",
            "discover": "0",
            "event_name": "",
            "uuid": "6ce467d05e8745409a177799bed34bb3",
            "url_name": "",
            "functions": [
                {
                    "functionid": "12598",
                    "itemid": "22454",
                    "triggerid": "13272",
                    "parameter": "$",
                    "function": "last"
                }
            ]
        },
        {
            "triggerid": "13266",
            "expression": "{13500}<20",
            "description": "Brīvā diska vieta ir mazāka par 20% sējumā {#FSNAME}",
            "url": "",
            "status": "0",
            "value": "0",
            "priority": "2",
            "lastchange": "0",
            "comments": "",
            "error": "",
            "templateid": "0",
            "type": "0",
            "state": "0",
            "flags": "2",
            "recovery_mode": "0",
            "recovery_expression": "",
            "correlation_mode": "0",
            "correlation_tag": "",
            "manual_close": "0",
            "opdata": "",
            "discover": "0",
            "event_name": "",
            "uuid": "74a1fc62bfe24b7eabe4e244c70dc384",
            "url_name": "",
            "functions": [
                {
                    "functionid": "13500",
                    "itemid": "22686",
                    "triggerid": "13266",
                    "parameter": "$",
                    "function": "last"
                }
            ]
        }
    ],
    "id": 1
}

Konkrēta trigera prototipa izgūšana ar tagiem

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "triggerprototype.get",
    "params": {
        "output": [
            "triggerid",
            "description"
        ],
        "selectTags": "extend",
        "triggerids": [
            "17373"
        ]
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "triggerid": "17373",
            "description": "Brīvā diska vieta ir mazāka par 20% sējumā {#FSNAME}",
            "tags": [
                {
                    "tag": "volume",
                    "value": "{#FSNAME}"
                },
                {
                    "tag": "type",
                    "value": "{#FSTYPE}"
                }
            ]
        }
    ],
    "id": 1
}

Skatīt arī

Avots

CTriggerPrototype::get() failā ui/include/classes/api/services/CTriggerPrototype.php.