[comment]: # ({896915aa-896915aa}) # template.get [comment]: # ({/896915aa-896915aa}) [comment]: # ({808af69c-4e400711}) ### Opis `integer/array template.get(object parameters)` Metoda umożliwia pobieranie szablonów zgodnie z podanymi parametrami. ::: noteclassic Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywołania metody mogą zostać odebrane w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji [Role użytkowników](/manual/web_interface/frontend_sections/users/user_roles). ::: [comment]: # ({/808af69c-4e400711}) [comment]: # ({bba4c1f2-97f0e40b}) ### Parametry `(object)` Parametry definiujące oczekiwany wynik. Metoda obsługuje następujące parametry. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |templateids|ID/array|Zwracaj tylko szablony o podanych ID szablonów.| |groupids|ID/array|Zwracaj tylko szablony należące do podanych grup szablonów.| |parentTemplateids|ID/array|Zwracaj tylko szablony, z którymi podany szablon jest powiązany.| |hostids|ID/array|Zwracaj tylko szablony powiązane z podanymi hostami/szablonami.| |graphids|ID/array|Zwracaj tylko szablony zawierające podane wykresy.| |itemids|ID/array|Zwracaj tylko szablony zawierające podane pozycje.| |triggerids|ID/array|Zwracaj tylko szablony zawierające podane wyzwalacze.| |with\_items|flag|Zwracaj tylko szablony, które mają pozycje.| |with\_triggers|flag|Zwracaj tylko szablony, które mają wyzwalacze.| |with\_graphs|flag|Zwracaj tylko szablony, które mają wykresy.| |with\_httptests|flag|Zwracaj tylko szablony, które mają scenariusze web.| |evaltype|integer|Metoda [oceny tagów](/manual/web_interface/frontend_sections/data_collection/hosts#using-filter).

Możliwe wartości:
0 - *(domyślnie)* I/Lub;
2 - Lub.| |tags|object/array|Zwracaj tylko szablony z podanymi tagami.
Format: `[{"tag": "", "value": "", "operator": ""}, ...]`.
Pusta tablica zwraca wszystkie szablony.

Możliwe wartości [operatora](/manual/web_interface/frontend_sections/data_collection/hosts#using-filter):
0 - *(domyślnie)* Zawiera;
1 - Równa się;
2 - Nie zawiera;
3 - Nie równa się;
4 - Istnieje;
5 - Nie istnieje.| |selectTags|query|Zwraca tagi szablonu w właściwości [`tags`](/manual/api/reference/template/object#template-tag).| |selectDiscoveryRules|query|Zwraca właściwość [`discoveryRules`](/manual/api/reference/discoveryrule/object) z regułami LLD szablonu.

Obsługuje `count`.| |selectHosts|query|Zwraca hosty powiązane z szablonem w właściwości [`hosts`](/manual/api/reference/host/object).

Obsługuje `count`.| |selectTemplateGroups|query|Zwraca grupy szablonów, do których należy szablon, w właściwości [`templategroups`](/manual/api/reference/templategroup/object).| |selectTemplates|query|Zwraca szablony, z którymi podany szablon jest powiązany, w właściwości [`templates`](/manual/api/reference/template/object).

Obsługuje `count`.| |selectParentTemplates|query|Zwraca szablony powiązane z podanym szablonem w właściwości `parentTemplates`.

Obsługuje `count`.| |selectHttpTests|query|Zwraca scenariusze web z szablonu w właściwości [`httpTests`](/manual/api/reference/httptest/object).

Obsługuje `count`.| |selectItems|query|Zwraca pozycje z szablonu w właściwości [`items`](/manual/api/reference/item/object).

Obsługuje `count`.| |selectTriggers|query|Zwraca wyzwalacze z szablonu w właściwości [`triggers`](/manual/api/reference/trigger/object).

Obsługuje `count`.| |selectGraphs|query|Zwraca wykresy z szablonu w właściwości [`graphs`](/manual/api/reference/graph/object).

Obsługuje `count`.| |selectMacros|query|Zwraca makra z szablonu w właściwości [`macros`](/manual/api/reference/usermacro/object#host-macro).| |selectDashboards|query|Zwraca dashboardy z szablonu w właściwości [`dashboards`](/manual/api/reference/templatedashboard/object).

Obsługuje `count`.| |selectValueMaps|query|Zwraca właściwość [`valuemaps`](/manual/api/reference/valuemap/object) z mapami wartości szablonu.| |limitSelects|integer|Ogranicza liczbę rekordów zwracanych przez podzapytania.

Dotyczy następujących podzapytań:
`selectTemplates` - wyniki będą sortowane według `name`;
`selectHosts` - sortowane według `host`;
`selectParentTemplates` - sortowane według `host`;
`selectItems` - sortowane według `name`;
`selectDiscoveryRules` - sortowane według `name`;
`selectTriggers` - sortowane według `description`;
`selectGraphs` - sortowane według `name`;
`selectDashboards` - sortowane według `name`.| |sortfield|string/array|Sortuje wynik według podanych właściwości.

Możliwe wartości: `hostid`, `host`, `name`, `status`.| |countOutput|boolean|Te parametry są opisane w [komentarzu referencyjnym](/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|^| |selectDiscoveries|query|Zwraca odkrycia niskiego poziomu z szablonu w właściwości `discoveries`.

Obsługuje `count`.

To zapytanie jest **przestarzałe**, zamiast niego użyj `selectDiscoveryRules`.| [comment]: # ({/bba4c1f2-97f0e40b}) [comment]: # ({7223bab1-7223bab1}) ### Zwracane wartości `(integer/array)` Zwraca: - tablicę obiektów; - liczbę pobranych obiektów, jeśli użyto parametru `countOutput`. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Przykłady [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({418c03b3-7e546e9a}) #### Pobieranie szablonów według nazwy Pobierz wszystkie dane dotyczące dwóch szablonów o nazwach "Linux" i "Windows". [Żądanie](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "template.get", "params": { "output": "extend", "filter": { "host": [ "Linux by Zabbix agent", "Windows by Zabbix agent" ] } }, "id": 1 } ``` Odpowiedź: ```json { "jsonrpc": "2.0", "result": [ { "proxyid": "0", "host": "Linux by Zabbix agent", "status": "3", "ipmi_authtype": "-1", "ipmi_privilege": "2", "ipmi_username": "", "ipmi_password": "", "maintenanceid": "0", "maintenance_status": "0", "maintenance_type": "0", "maintenance_from": "0", "name": "Linux by Zabbix agent", "flags": "0", "templateid": "10001", "description": "To jest oficjalny szablon dla systemu Linux. Wymaga agent Zabbix 7.4 lub nowszego.\r\n\r\nUwagi dotyczące wykrywania systemów plików (FS):\r\n- System plików ext4/3/2 rezerwuje miejsce do użytku uprzywilejowanego, zwykle domyślnie ustawione na 5%.\r\n- BTRFS domyślnie przydziela 10% woluminu na własne potrzeby.\r\n- Aby ograniczyć potencjalne problemy, wyzwalacze wykorzystania FS są oparte na maksymalnej dostępnej przestrzeni.\r\n - Wzór wykorzystania: 'pused = 100 - 100 * (available / total - free + available)'\r\n- Wykres wykorzystania FS, pochodzący z prototypów wykresów, odzwierciedla zarezerwowane miejsce FS jako różnicę między zajętym a dostępnym miejscem w całym woluminie.\r\n\r\nMożesz omówić ten szablon lub zostawić opinię na naszym forum https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/387225-discussion-thread-for-official-zabbix-template-for-linux\r\n\r\nWygenerowano przy użyciu oficjalnego narzędzia do szablonów Zabbix \"Templator\"", "tls_connect": "1", "tls_accept": "1", "tls_issuer": "", "tls_subject": "", "tls_psk_identity": "", "tls_psk": "", "custom_interfaces": "0", "uuid": "f8f7908280354f2abeed07dc788c3747", "vendor_name": "Zabbix", "vendor_version": "7.4-2", "proxy_groupid": "0", "monitored_by": "0", "wizard_ready": "1", "readme": "## Omówienie\r\n\r\nTo jest oficjalny szablon dla systemu Linux. Wymaga agent Zabbix 7.4 lub nowszego.\r\n\r\n#### Uwagi dotyczące wykrywania systemów plików (FS):\r\n- System plików ext4/3/2 rezerwuje miejsce do użytku uprzywilejowanego, zwykle domyślnie ustawione na 5%.\r\n- BTRFS domyślnie przydziela 10% woluminu na własne potrzeby.\r\n- Aby ograniczyć potencjalne problemy, wyzwalacze wykorzystania FS są oparte na maksymalnej dostępnej przestrzeni.\r\n - Wzór wykorzystania: `pused = 100 - 100 * (available / total - free + available)`\r\n- Wykres wykorzystania FS, pochodzący z prototypów wykresów, odzwierciedla zarezerwowane miejsce FS jako różnicę między zajętym a dostępnym miejscem w całym woluminie." }, { "proxyid": "0", "host": "Windows by Zabbix agent", "status": "3", "ipmi_authtype": "-1", "ipmi_privilege": "2", "ipmi_username": "", "ipmi_password": "", "maintenanceid": "0", "maintenance_status": "0", "maintenance_type": "0", "maintenance_from": "0", "name": "Windows by Zabbix agent", "flags": "0", "templateid": "10081", "description": "To jest oficjalny szablon dla systemu Windows. Wymaga agent Zabbix 7.4 lub nowszego.\r\n\r\nMożesz omówić ten szablon lub zostawić opinię na naszym forum https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/387224-discussion-thread-for-official-zabbix-template-for-windows\r\n\r\nWygenerowano przy użyciu oficjalnego narzędzia do szablonów Zabbix \"Templator\"", "tls_connect": "1", "tls_accept": "1", "tls_issuer": "", "tls_subject": "", "tls_psk_identity": "", "tls_psk": "", "custom_interfaces": "0", "uuid": "13b06904a6bf41cbb795e3193d896340", "vendor_name": "Zabbix", "vendor_version": "7.4-2", "proxy_groupid": "0", "monitored_by": "0", "wizard_ready": "1", "readme": "## Omówienie\r\n\r\nTo jest oficjalny szablon dla systemu Windows. Wymaga agent Zabbix 7.4 lub nowszego." } ], "id": 1 } ``` [comment]: # ({/418c03b3-7e546e9a}) [comment]: # ({4e2a2df6-84d0cbf3}) #### Pobieranie grup szablonów Pobierz grupy szablonów, do których należy szablon „Linux by Zabbix agent”. [Żądanie](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "template.get", "params": { "output": ["hostid"], "selectTemplateGroups": "extend", "filter": { "host": [ "Linux by Zabbix agent" ] } }, "id": 1 } ``` Odpowiedź: ```json { "jsonrpc": "2.0", "result": [ { "templateid": "10001", "templategroups": [ { "groupid": "10", "name": "Templates/Operating systems", "uuid": "846977d1dfed4968bc5f8bdb363285bc" } ] } ], "id": 1 } ``` [comment]: # ({/4e2a2df6-84d0cbf3}) [comment]: # ({ce53b2e1-a8599e09}) #### Pobieranie hostów według szablonu Pobierz hosty, które mają podłączony szablon „10001” (*Linux by Zabbix agent*). [Żądanie](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "template.get", "params": { "output": "templateid", "templateids": "10001", "selectHosts": ["hostid", "name"] }, "id": 1 } ``` Odpowiedź: ```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}) #### Wyszukiwanie według tagów szablonu Pobierz szablony, które mają tag "host-name" równy "{HOST.NAME}". [Żądanie](/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 } ``` Odpowiedź: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10402", "tags": [ { "tag": "host-name", "value": "{HOST.NAME}" } ] } ], "id": 1 } ``` [comment]: # ({/3380e3c0-0fe2d603}) [comment]: # ({45da1f59-ee3fc022}) ### Zobacz także - [Grupa szablonów](/manual/api/reference/templategroup/object#template-group) - [Szablon](object#template) - [Makro użytkownika](/manual/api/reference/usermacro/object#hosttemplate-level-macro) - [Interfejs hosta](/manual/api/reference/hostinterface/object#host-interface) [comment]: # ({/45da1f59-ee3fc022}) [comment]: # ({4fdbde5d-4fdbde5d}) ### Źródło CTemplate::get() w *ui/include/classes/api/services/CTemplate.php*. [comment]: # ({/4fdbde5d-4fdbde5d})