[comment]: # translation:outdated

[comment]: # ({896915aa-896915aa})
# template.get

[comment]: # ({/896915aa-896915aa})

[comment]: # ({808af69c-4e400711})
### Опис

`integer/array template.get(object parameters)`

Метода омогућава преузимање шаблона према датим 
параметрима.

::: noteclassic
Ова метода је доступна корисницима било ког типа. Дозволе
за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте [Корисничка
улога](/manual/web_interface/frontend_sections/users/user_roles) 
за више информација.
:::

[comment]: # ({/808af69c-4e400711})

[comment]: # ({a5949d29-97f0e40b})
### Параметри

`(object)` Параметри који дефинишу жељени излаз.

Метода подржава следеће параметре.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|templateids|ID/array|Врати само шаблоне са датим ID-ијевима шаблона.|
|groupids|ID/array|Врати само шаблоне који припадају датим групама шаблона.|
|parentTemplateids|ID/array|Врати само шаблоне са којима је дати шаблон повезан.|
|hostids|ID/array|Врати само шаблоне који су повезани са датим домаћинима/шаблонима.|
|graphids|ID/array|Врати само шаблоне који садрже дате графиконе.|
|itemids|ID/array|Врати само шаблоне који садрже дате ставке.|
|triggerids|ID/array|Врати само шаблоне који садрже дате окидаче.|
|with\_items|flag|Врати само шаблоне који имају ставке.|
|with\_triggers|flag|Врати само шаблоне који имају окидаче.|
|with\_graphs|flag|Врати само шаблоне који имају графиконе.|
|with\_httptests|flag|Врати само шаблоне који имају веб сценарије.|
|evaltype|integer|Правила за претрагу ознака.<br><br>Могуће вредности:<br>0 - (подразумевано) И/Или;<br>2 - Или.|
|tags|object/array|Врати само шаблоне са датим ознакама. Тачно подударање по ознаци и претрага са осетљивошћу на велика и мала слова или без осетљивости на велика и мала слова по вредности ознаке у зависности од вредности оператора.<br>Формат: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>Празан низ враћа све шаблоне.<br><br>Могуће вредности оператора:<br>0 - (подразумевано) Садржи;<br>1 - Једнако;<br>2 - Није слично;<br>3 - Није једнако;<br>4 - Постоји;<br>5 - Не постоји.|
|selectTags|query|Враћа ознаке шаблона у својству [`tags`](/manual/api/reference/template/object#template_tag).|
|selectHosts|query|Враћа домаћине који су повезани са шаблоном у својству [`hosts`](/manual/api/reference/host/object).<br><br>Подржава `count`.|
|selectTemplateGroups|query|Враћа групе шаблона којима шаблон припада у својству [`templategroups`](/manual/api/reference/templategroup/object).|
|selectTemplates|query|Враћа шаблоне са којима је дати шаблон повезан у својству [`templates`](/manual/api/reference/template/object).<br><br>Подржава `count`.|
|selectParentTemplates|query|Враћа шаблоне који су повезани са датим шаблоном у својству `parentTemplates`.<br><br>Подржава `count`.|
|selectHttpTests|query|Враћа веб сценарије из шаблона у својству [`httpTests`](/manual/api/reference/httptest/object).<br><br>Подржава `count`.|
|selectItems|query|Враћа ставке из шаблона у својству [`items`](/manual/api/reference/item/object).<br><br>Подржава `count`.|
|selectDiscoveries|query|Враћа открића ниског нивоа из шаблона у својству `discoveries`.<br><br>Подржава `count`.|
|selectTriggers|query|Враћа окидаче из шаблона у својству [`triggers`](/manual/api/reference/trigger/object).<br><br>Подржава `count`.|
|selectGraphs|query|Враћа графиконе из шаблона у својству [`graphs`](/manual/api/reference/graph/object).<br><br>Подржава `count`.|
|selectMacros|query|Враћа макрое из шаблона у својству [`macros`](/manual/api/reference/usermacro/object#host-macro).|
|selectDashboards|query|Враћа контролне табле из шаблона у својству [`dashboards`](/manual/api/reference/templatedashboard/object).<br><br>Подржава `count`.|
|selectValueMaps|query|Враћа својство [`valuemaps`](/manual/api/reference/valuemap/object) са мапама вредности шаблона.|
|limitSelects|integer|Ограничава број записа које враћају подизбори.<br><br>Односи се на следеће подизборе:<br>`selectTemplates` - резултати ће бити сортирани по `name`;<br>`selectHosts` - сортирано по `host`;<br>`selectParentTemplates` - сортирано по `host`;<br>`selectItems` - сортирано по `name`;<br>`selectDiscoveries` - сортирано по `name`;<br>`selectTriggers` - сортирано по `description`;<br>`selectGraphs` - сортирано по `name`;<br>`selectDashboards` - сортирано по `name`.|
|sortfield|string/array|Сортира резултат по датим својствима.<br><br>Могуће вредности: `hostid`, `host`, `name`, `status`.|
|countOutput|boolean|Ови параметри су описани у [коментару референце](/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|^|

[comment]: # ({/a5949d29-97f0e40b})

[comment]: # ({7223bab1-7223bab1})
### Повратне вредности

`(integer/array)` Враћа било:

-     низ објеката;
-     број преузетих објеката, ако је параметар `countOutput` 
коришћен.

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### Примери

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({418c03b3-7e546e9a})
#### Преузимање шаблона по имену

Преузимање свих података о два шаблона под називом "Linux" и "Windows".

[Захтев](/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
}
```

Одговор:

```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": "Ово је званични Linux шаблон. Потребан је Zabbix агент 7.4 или новији.\r\n\r\nНапомене о откривању фајл система (FS):\r\n- Фајл систем ext4/3/2 резервише простор за привилеговану употребу, обично подразумевано подешен на 5%.\r\n- BTRFS додељује подразумевано 10% запремине за сопствене потребе.\r\n- Да би се ублажиле потенцијалне катастрофе, окидачи коришћења FS-а заснивају се на максимално доступном простору.\r\n- Формула коришћења: 'pused = 100 - 100 * (доступно / укупно - слободно + доступно)'\r\n- Графикон искоришћења ФС-а, изведен из прототипова графова, одражава резервисани простор ФС-а као разлику између коришћеног и расположивог простора од укупне запремине.\r\n\r\nМожете разговарати о овом шаблону или оставити повратне информације на нашем форуму https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/387225-discussion-thread-for-official-zabbix-template-for-linux\r\n\r\nГенерисано званичним алатом за шаблоне 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": "## Преглед\r\n\r\nОво је званични Linux шаблон. Потребан је Zabbix агент 7.4 или новији.\r\n\r\n#### Напомене о откривању фајл система (FS):\r\n- ext4/3/2 FS резервише простор за привилеговану употребу, обично подразумевано подешен на 5%.\r\n- BTRFS додељује подразумевано 10% запремине за сопствене потребе.\r\n- Да би се ублажиле потенцијалне катастрофе, окидачи коришћења FS-а заснивају се на максимално доступном простору.\r\n - Формула искоришћења: `pused = 100 - 100 * (доступно / укупно - слободно + доступно)`\r\n- Графикон искоришћења простора за складиштење података, изведен из прототипова графова, одражава резервисани простор за складиштење података као разлику између коришћеног и доступног простора из укупне запремине.
   },
   {
   "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": "Ово је званични Windows шаблон. Потребан је Zabbix агент 7.4 или новији.\r\n\r\nМожете разговарати о овом шаблону или оставити повратне информације на нашем форуму." https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/387224-discussion-thread-for-official-zabbix-template-for-windows\r\n\r\nГенерисано званичним алатом за шаблоне 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": "## Преглед\r\n\r\nОво је званични Windows шаблон. Потребан је Zabbix агент 7.4 или новији."
   }
   ],
   "id": 1
}
```

[comment]: # ({/418c03b3-7e546e9a})

[comment]: # ({4e2a2df6-84d0cbf3})
#### Преузимање група шаблона 

Преузми групе шаблона чији је члан шаблон "Linux by Zabbix agent".

[Захтев](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "template.get",
    "params": {
        "output": ["hostid"],
        "selectTemplateGroups": "extend",
        "filter": {
            "host": [
                "Linux by Zabbix agent"
            ]
        }
    },
    "id": 1
}
```

Одговор:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "templateid": "10001",
            "templategroups": [
                {
                    "groupid": "10",
                    "name": "Templates/Operating systems",
                    "uuid": "846977d1dfed4968bc5f8bdb363285bc"
                }
            ]
        }
    ],
    "id": 1
}
```

[comment]: # ({/4e2a2df6-84d0cbf3})

[comment]: # ({ce53b2e1-a8599e09})
#### Преузимање домаћина по шаблону

Преузмите домаћине са којима је повезан шаблон "10001" (*Linux by Zabbix agent*).

[Захтев](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "template.get",
    "params": {
        "output": "templateid",
        "templateids": "10001",
        "selectHosts": ["hostid", "name"]
    },
    "id": 1
}
```

Одговор:

```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})
#### Претраживање по ознакама шаблона

Преузмите шаблоне који имају ознаку "host-name" једнаку "{HOST.NAME}".

[Захтев](/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
}
```

Одговор:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "hostid": "10402",
            "tags": [
                {
                    "tag": "host-name",
                    "value": "{HOST.NAME}"
                }
            ]
        }
    ],
    "id": 1
}
```

[comment]: # ({/3380e3c0-0fe2d603})

[comment]: # ({6e0a148e-ee3fc022})
### Погледајте такође

-  [Група шаблона](/manual/api/reference/templategroup/object#template_group)
-  [Шаблон](object#template)
-  [Кориснички
    макро](/manual/api/reference/usermacro/object#hosttemplate_level_macro)
-  [Интерфејс
    домаћина](/manual/api/reference/hostinterface/object#host_interface)

[comment]: # ({/6e0a148e-ee3fc022})

[comment]: # ({4fdbde5d-4fdbde5d})
### Извор

CTemplate::get() у *ui/include/classes/api/services/CTemplate.php*.

[comment]: # ({/4fdbde5d-4fdbde5d})