[comment]: # ({896915aa-896915aa}) # veidne.get [comment]: # ({/896915aa-896915aa}) [comment]: # ({808af69c-4e400711}) ### Apraksts `integer/array template.get(object parameters)` Šī metode ļauj izgūt veidnes atbilstoši norādītajiem parametriem. ::: noteclassic Šī metode ir pieejama jebkura tipa lietotājiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet [Lietotāja lomas](/manual/web_interface/frontend_sections/users/user_roles). ::: [comment]: # ({/808af69c-4e400711}) [comment]: # ({d3a12b20-97f0e40b}) ### Parametri `(object)` Parametri, kas definē vēlamo izvadi. Metode atbalsta šādus parametrus. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |templateids|ID/array|Atgriezt tikai veidnes ar norādītajiem veidņu ID.| |groupids|ID/array|Atgriezt tikai veidnes, kas pieder norādītajām veidņu grupām.| |parentTemplateids|ID/array|Atgriezt tikai veidnes, ar kurām norādītā veidne ir saistīta.| |hostids|ID/array|Atgriezt tikai veidnes, kas ir saistītas ar norādītajiem hosts/veidnēm.| |graphids|ID/array|Atgriezt tikai veidnes, kas satur norādītos grafikus.| |itemids|ID/array|Atgriezt tikai veidnes, kas satur norādītos vienumus.| |triggerids|ID/array|Atgriezt tikai veidnes, kas satur norādītos trigerus.| |with\_items|flag|Atgriezt tikai veidnes, kurām ir vienumi.| |with\_triggers|flag|Atgriezt tikai veidnes, kurām ir trigeri.| |with\_graphs|flag|Atgriezt tikai veidnes, kurām ir grafiki.| |with\_httptests|flag|Atgriezt tikai veidnes, kurām ir tīmekļa scenāriji.| |evaltype|integer|Tagu [novērtēšanas metode](/manual/web_interface/frontend_sections/data_collection/hosts#using-filter).

Iespējamās vērtības:
0 - *(noklusējums)* Un/Or;
2 - Or.| |tags|object/array|Atgriezt tikai veidnes ar norādītajiem tagiem.
Formāts: `[{"tag": "", "value": "", "operator": ""}, ...]`.
Tukšs masīvs atgriež visas veidnes.

Iespējamās [operatora](/manual/web_interface/frontend_sections/data_collection/hosts#using-filter) vērtības:
0 - *(noklusējums)* Satur;
1 - Vienāds ar;
2 - Nesatur;
3 - Nav vienāds ar;
4 - Eksistē;
5 - Neeksistē.| |selectTags|query|Atgriezt veidnes tagus [`tags`](/manual/api/reference/template/object#template-tag) īpašībā.| |selectHosts|query|Atgriezt hosts, kas ir saistīti ar veidni, [`hosts`](/manual/api/reference/host/object) īpašībā.

Atbalsta `count`.| |selectTemplateGroups|query|Atgriezt veidņu grupas, kurām veidne pieder, [`templategroups`](/manual/api/reference/templategroup/object) īpašībā.| |selectTemplates|query|Atgriezt veidnes, ar kurām norādītā veidne ir saistīta, [`templates`](/manual/api/reference/template/object) īpašībā.

Atbalsta `count`.| |selectParentTemplates|query|Atgriezt veidnes, kas ir saistītas ar norādīto veidni, `parentTemplates` īpašībā.

Atbalsta `count`.| |selectHttpTests|query|Atgriezt tīmekļa scenārijus no veidnes, [`httpTests`](/manual/api/reference/httptest/object) īpašībā.

Atbalsta `count`.| |selectItems|query|Atgriezt vienumus no veidnes, [`items`](/manual/api/reference/item/object) īpašībā.

Atbalsta `count`.| |selectDiscoveries|query|Atgriezt zema līmeņa atklāšanas no veidnes, `discoveries` īpašībā.

Atbalsta `count`.| |selectTriggers|query|Atgriezt trigerus no veidnes, [`triggers`](/manual/api/reference/trigger/object) īpašībā.

Atbalsta `count`.| |selectGraphs|query|Atgriezt grafikus no veidnes, [`graphs`](/manual/api/reference/graph/object) īpašībā.

Atbalsta `count`.| |selectMacros|query|Atgriezt makro no veidnes, [`macros`](/manual/api/reference/usermacro/object#host-macro) īpašībā.| |selectDashboards|query|Atgriezt paneļus no veidnes, [`dashboards`](/manual/api/reference/templatedashboard/object) īpašībā.

Atbalsta `count`.| |selectValueMaps|query|Atgriezt [`valuemaps`](/manual/api/reference/valuemap/object) īpašību ar veidnes vērtību kartējumiem.| |limitSelects|integer|Ierobežo ierakstu skaitu, ko atgriež apakšatlases.

Attiecas uz šādām apakšatlasēm:
`selectTemplates` - rezultāti tiks kārtoti pēc `name`;
`selectHosts` - kārtoti pēc `host`;
`selectParentTemplates` - kārtoti pēc `host`;
`selectItems` - kārtoti pēc `name`;
`selectDiscoveries` - kārtoti pēc `name`;
`selectTriggers` - kārtoti pēc `description`;
`selectGraphs` - kārtoti pēc `name`;
`selectDashboards` - kārtoti pēc `name`.| |sortfield|string/array|Kārtot rezultātu pēc norādītajām īpašībām.

Iespējamās vērtības: `hostid`, `host`, `name`, `status`.| |countOutput|boolean|Šie parametri ir aprakstīti [atsauces komentārā](/manual/api/reference_commentary#common-get-method-parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| |selectGroups
(deprecated)|query|Šis parametrs ir novecojis, lūdzu, izmantojiet `selectTemplateGroups`.
Atgriezt veidņu grupas, kurām veidne pieder, [`groups`](/manual/api/reference/templategroup/object) īpašībā.| [comment]: # ({/d3a12b20-97f0e40b}) [comment]: # ({7223bab1-7223bab1}) ### Atgrieztās vērtības `(integer/array)` Atgriež vienu no šiem: - objektu masīvu; - izgūto objektu skaitu, ja ir izmantots parametrs `countOutput`. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Piemēri [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({dfae5d3a-7e546e9a}) #### Veidņu izgūšana pēc nosaukuma Iegūstiet visus datus par divām veidnēm ar nosaukumiem "Linux" un "Windows". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "template.get", "params": { "output": "extend", "filter": { "host": [ "Linux", "Windows" ] } }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "proxyid": "0", "host": "Linux", "status": "3", "disable_until": "0", "error": "", "available": "0", "errors_from": "0", "lastaccess": "0", "ipmi_authtype": "0", "ipmi_privilege": "2", "ipmi_username": "", "ipmi_password": "", "ipmi_disable_until": "0", "ipmi_available": "0", "snmp_disable_until": "0", "snmp_available": "0", "maintenanceid": "0", "maintenance_status": "0", "maintenance_type": "0", "maintenance_from": "0", "ipmi_errors_from": "0", "snmp_errors_from": "0", "ipmi_error": "", "snmp_error": "", "jmx_disable_until": "0", "jmx_available": "0", "jmx_errors_from": "0", "jmx_error": "", "name": "Linux", "flags": "0", "templateid": "10001", "description": "", "tls_connect": "1", "tls_accept": "1", "tls_issuer": "", "tls_subject": "", "tls_psk_identity": "", "tls_psk": "", "uuid": "282ffe33afc74cccaf1524d9aa9dc502" }, { "proxyid": "0", "host": "Windows", "status": "3", "disable_until": "0", "error": "", "available": "0", "errors_from": "0", "lastaccess": "0", "ipmi_authtype": "0", "ipmi_privilege": "2", "ipmi_username": "", "ipmi_password": "", "ipmi_disable_until": "0", "ipmi_available": "0", "snmp_disable_until": "0", "snmp_available": "0", "maintenanceid": "0", "maintenance_status": "0", "maintenance_type": "0", "maintenance_from": "0", "ipmi_errors_from": "0", "snmp_errors_from": "0", "ipmi_error": "", "snmp_error": "", "jmx_disable_until": "0", "jmx_available": "0", "jmx_errors_from": "0", "jmx_error": "", "name": "Windows", "flags": "0", "templateid": "10081", "description": "", "tls_connect": "1", "tls_accept": "1", "tls_issuer": "", "tls_subject": "", "tls_psk_identity": "", "tls_psk": "", "uuid": "522d17e1834049be879287b7c0518e5d" } ], "id": 1 } ``` [comment]: # ({/dfae5d3a-7e546e9a}) [comment]: # ({4e2a2df6-84d0cbf3}) #### Veidņu grupu izgūšana Izgūstiet veidņu grupas, kuru dalībnieks ir veidne "Linux by Zabbix aģents". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "template.get", "params": { "output": ["hostid"], "selectTemplateGroups": "extend", "filter": { "host": [ "Linux by Zabbix agent" ] } }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "templateid": "10001", "templategroups": [ { "groupid": "10", "name": "Templates/Operating systems", "uuid": "846977d1dfed4968bc5f8bdb363285bc" } ] } ], "id": 1 } ``` [comment]: # ({/4e2a2df6-84d0cbf3}) [comment]: # ({ce53b2e1-a8599e09}) #### Hostu izgūšana pēc veidnes Izgūstiet hostus, kuriem ir piesaistīta veidne "10001" (*Linux by Zabbix aģents*). [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "template.get", "params": { "output": "templateid", "templateids": "10001", "selectHosts": ["hostid", "name"] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "templateid": "10001", "hosts": [ { "hostid": "10084", "name": "Zabbix server" }, { "hostid": "10603", "name": "Host 1" }, { "hostid": "10604", "name": "Host 2" } ] } ], "id": 1 } ``` [comment]: # ({/ce53b2e1-a8599e09}) [comment]: # ({3380e3c0-0fe2d603}) #### Meklēšana pēc veidnes tagiem Iegūstiet veidnes, kurām tags "host-name" ir vienāds ar "{HOST.NAME}". [Pieprasījums](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "template.get", "params": { "output": ["hostid"], "selectTags": "extend", "evaltype": 0, "tags": [ { "tag": "host-name", "value": "{HOST.NAME}", "operator": 1 } ] }, "id": 1 } ``` Atbilde: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10402", "tags": [ { "tag": "host-name", "value": "{HOST.NAME}" } ] } ], "id": 1 } ``` [comment]: # ({/3380e3c0-0fe2d603}) [comment]: # ({a0ef7cf5-ee3fc022}) ### Skatīt arī - [Veidņu grupa](/manual/api/reference/templategroup/object#template-group) - [Veidne](object#template) - [Lietotāja makro](/manual/api/reference/usermacro/object#hosttemplate-level-macro) - [Hosts interfeiss](/manual/api/reference/hostinterface/object#host-interface) [comment]: # ({/a0ef7cf5-ee3fc022}) [comment]: # ({4fdbde5d-4fdbde5d}) ### Avots CTemplate::get() failā *ui/include/classes/api/services/CTemplate.php*. [comment]: # ({/4fdbde5d-4fdbde5d})