[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. Zobacz [Role użytkowników](/manual/web_interface/frontend_sections/users/user_roles), aby uzyskać więcej informacji.
:::

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

[comment]: # ({d3a12b20-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 etykiet](/manual/web_interface/frontend_sections/data_collection/hosts#using-filter).<br><br>Possible values:<br>0 - *(default)* And/Or;<br>2 - Or.|
|tags|object/array|Zwracaj tylko szablony o podanych etykietach.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>Pusta tablica zwraca wszystkie szablony.<br><br>Possible [operator](/manual/web_interface/frontend_sections/data_collection/hosts#using-filter) values:<br>0 - *(default)* Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.|
|selectTags|query|Zwraca etykiety szablonu w właściwości [`tags`](/manual/api/reference/template/object#template-tag).|
|selectHosts|query|Zwraca hosty powiązane z szablonem w właściwości [`hosts`](/manual/api/reference/host/object).<br><br>Supports `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).<br><br>Supports `count`.|
|selectParentTemplates|query|Zwraca szablony, które są powiązane z podanym szablonem, w właściwości `parentTemplates`.<br><br>Supports `count`.|
|selectHttpTests|query|Zwraca scenariusze web z szablonu w właściwości [`httpTests`](/manual/api/reference/httptest/object).<br><br>Supports `count`.|
|selectItems|query|Zwraca pozycje z szablonu w właściwości [`items`](/manual/api/reference/item/object).<br><br>Supports `count`.|
|selectDiscoveries|query|Zwraca wykrycia niskiego poziomu z szablonu w właściwości `discoveries`.<br><br>Supports `count`.|
|selectTriggers|query|Zwraca wyzwalacze z szablonu w właściwości [`triggers`](/manual/api/reference/trigger/object).<br><br>Supports `count`.|
|selectGraphs|query|Zwraca wykresy z szablonu w właściwości [`graphs`](/manual/api/reference/graph/object).<br><br>Supports `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).<br><br>Supports `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.<br><br>Dotyczy następujących podzapytań:<br>`selectTemplates` - wyniki będą sortowane według `name`;<br>`selectHosts` - sortowane według `host`;<br>`selectParentTemplates` - sortowane według `host`;<br>`selectItems` - sortowane według `name`;<br>`selectDiscoveries` - sortowane według `name`;<br>`selectTriggers` - sortowane według `description`;<br>`selectGraphs` - sortowane według `name`;<br>`selectDashboards` - sortowane według `name`.|
|sortfield|string/array|Sortuje wynik według podanych właściwości.<br><br>Possible values: `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|^|
|selectGroups<br>(deprecated)|query|Ten parametr jest przestarzały, użyj zamiast niego `selectTemplateGroups`.<br>Zwraca grupy szablonów, do których należy szablon, w właściwości [`groups`](/manual/api/reference/templategroup/object).|

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

[comment]: # ({7223bab1-7223bab1})
### Wartości zwracane

`(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]: # ({dfae5d3a-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",
                "Windows"
            ]
        }
    },
    "id": 1
}
```

Odpowiedź:

```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})
#### 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]: # ({a0ef7cf5-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]: # ({/a0ef7cf5-ee3fc022})

[comment]: # ({4fdbde5d-4fdbde5d})
### Źródło

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

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