Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet Lietotāju lomas.

Parametri

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

Metode atbalsta šādus parametrus.

Parametrs	Tips	Apraksts
active	flag	Atgriezt tikai iespējotus trigeru prototipus, kas pieder uzraudzītiem hostiem.
discoveryids	ID/array	Atgriezt tikai trigeru prototipus, kas pieder norādītajiem LLD noteikumiem.
functions	string/array	Atgriezt tikai trigerus, kas izmanto norādītās funkcijas. Atbalstīto funkciju sarakstu skatiet lapā Atbalstītās funkcijas.
group	string	Atgriezt tikai trigeru prototipus, kas pieder hostiem 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 hostiem vai veidnēm no norādītajām hostu grupām vai veidņu grupām.
host	string	Atgriezt tikai trigeru prototipus, kas pieder hostiem ar norādīto nosaukumu.
hostids	ID/array	Atgriezt tikai trigeru prototipus, kas pieder norādītajiem hostiem.
inherited	boolean	Ja iestatīts uz `true`, atgriezt tikai no veidnes mantotos trigeru prototipus.
maintenance	boolean	Ja iestatīts uz `true`, atgriezt tikai iespējotus trigeru prototipus, kas pieder hostiem 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 hostiem 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 makrosus trigera izteiksmē.
selectDependencies	query	Atgriezt trigeru prototipus un trigerus, no kuriem trigeru prototips ir atkarīgs, īpašībā `dependencies`.
selectDiscoveryData	query	Atgriezt īpašību `discoveryData` ar trigera prototipa atklāšanas objekta datiem. Trigera prototipa atklāšanas objekts sasaista atklātu trigera prototipu ar trigera prototipu, no kura tas tika atklāts. Tam ir šādas īpašības: `parent_triggerid` - `(ID)` tā trigera prototipa ID, no kura trigera prototips ir izveidots; `status` - `(int)` trigera prototipa atklāšanas statuss: 0 - (noklusējums) trigera prototips ir atklāts, 1 - trigera prototips vairs netiek atklāts; `ts_delete` - `(timestamp)` laiks, kad trigera prototips, kas vairs netiek atklāts, tiks dzēsts; `ts_disable` - `(timestamp)` laiks, kad trigera prototips, kas vairs netiek atklāts, tiks atspējots; `disable_source` - `(int)` norāde, vai trigera prototips tika atspējots ar LLD noteikumu vai manuāli: 0 - (noklusējums) atspējots automātiski, 1 - atspējots ar LLD noteikumu.
selectDiscoveryRule	query	Atgriezt LLD noteikumu, kuram pieder trigera prototips, īpašībā `discoveryRule`.
selectDiscoveryRulePrototype	query	Atgriezt īpašību `discoveryRulePrototype` ar vecāka LLD noteikuma prototipu, kuram pieder trigera prototips.
selectFunctions	query	Atgriezt trigera prototipā izmantotās funkcijas īpašībā `functions`. Funkciju objekti attēlo trigera izteiksmē izmantotās funkcijas, un tiem ir šādas īpašības: `functionid` - `(ID)` funkcijas ID; `itemid` - `(ID)` funkcijā izmantotā vienuma ID; `function` - `(string)` funkcijas nosaukums; `parameter` - `(string)` funkcijai nodotais parametrs. Vaicājuma parametrs atgrieztajā virknē tiek aizstāts ar simbolu `$`.
selectHostGroups	query	Atgriezt hostu grupas, kurām pieder trigera prototips, īpašībā `hostgroups`.
selectHosts	query	Atgriezt hostus, kuriem pieder trigera prototips, īpašībā `hosts`.
selectInheritedTags	query	Atgriezt īpašību `inheritedTags` ar birkām, kas mantotas no veidnēm, piesaistītajām veidnēm un hostiem, kā arī no vienumu prototipiem, uz kuriem ir atsauce trigera vai atkopšanas izteiksmēs.
selectItems	query	Atgriezt vienumus un vienumu prototipus, ko izmanto trigera prototips, īpašībā `items`.
selectTags	query	Atgriezt trigera prototipa birkas īpašībā `tags`.
selectTemplateGroups	query	Atgriezt veidņu grupas, kurām pieder trigera prototips, īpašībā `templategroups`.
filter	object	Atgriezt tikai tos rezultātus, kas precīzi atbilst norādītajam filtram. Pieņem objektu, kur atslēgas ir īpašību nosaukumi, bet vērtības ir vai nu viena vērtība, vai vērtību masīvs, ar ko salīdzināt. Neatbalsta `text` datu tipa īpašības. Atbalsta papildu īpašības: `host` - tā hosta tehniskais nosaukums, kuram pieder trigera prototips; `hostid` - tā hosta ID, kuram pieder trigera prototips.
limitSelects	integer	Ierobežo apakšatlases vaicājumos 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ītajām īpašībām. Iespējamās vērtības: `triggerid`, `description`, `status`, `priority`, `discovered`.
countOutput	boolean	Šie parametri ir aprakstīti atsauces komentārā.
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.

What’s next?

triggerprototype.update

Docs

triggerprototype.get

Apraksts