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

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

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

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

Die Methode ermöglicht das Abrufen von Vorlagen entsprechend den angegebenen
Parametern.

::: noteclassic
Diese Methode ist für Benutzer aller Typen verfügbar. Berechtigungen
zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle widerrufen werden. Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(object)` Parameter, die die gewünschte Ausgabe definieren.

Die Methode unterstützt die folgenden Parameter.

|Parameter|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|templateids|ID/array|Nur Vorlagen mit den angegebenen Vorlagen-IDs zurückgeben.|
|groupids|ID/array|Nur Vorlagen zurückgeben, die zu den angegebenen Vorlagengruppen gehören.|
|parentTemplateids|ID/array|Nur Vorlagen zurückgeben, mit denen die angegebene Vorlage verknüpft ist.|
|hostids|ID/array|Nur Vorlagen zurückgeben, die mit den angegebenen Hosts/Vorlagen verknüpft sind.|
|graphids|ID/array|Nur Vorlagen zurückgeben, die die angegebenen Diagramme enthalten.|
|itemids|ID/array|Nur Vorlagen zurückgeben, die die angegebenen Datenpunkte enthalten.|
|triggerids|ID/array|Nur Vorlagen zurückgeben, die die angegebenen Auslöser enthalten.|
|with\_items|flag|Nur Vorlagen zurückgeben, die Datenpunkte haben.|
|with\_triggers|flag|Nur Vorlagen zurückgeben, die Auslöser haben.|
|with\_graphs|flag|Nur Vorlagen zurückgeben, die Diagramme haben.|
|with\_httptests|flag|Nur Vorlagen zurückgeben, die Webszenarien haben.|
|evaltype|integer|Tag-[Auswertungsmethode](/manual/web_interface/frontend_sections/data_collection/hosts#using-filter).<br><br>Mögliche Werte:<br>0 - *(Standard)* Und/Oder;<br>2 - Oder.|
|tags|object/array|Nur Vorlagen mit den angegebenen Tags zurückgeben.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>Ein leeres Array gibt alle Vorlagen zurück.<br><br>Mögliche [Operator](/manual/web_interface/frontend_sections/data_collection/hosts#using-filter)-Werte:<br>0 - *(Standard)* Enthält;<br>1 - Entspricht;<br>2 - Enthält nicht;<br>3 - Entspricht nicht;<br>4 - Existiert;<br>5 - Existiert nicht.|
|selectTags|query|Vorlagen-Tags in der Eigenschaft [`tags`](/manual/api/reference/template/object#template-tag) zurückgeben.|
|selectHosts|query|Die Hosts zurückgeben, die mit der Vorlage in der Eigenschaft [`hosts`](/manual/api/reference/host/object) verknüpft sind.<br><br>Unterstützt `count`.|
|selectTemplateGroups|query|Die Vorlagengruppen zurückgeben, zu denen die Vorlage in der Eigenschaft [`templategroups`](/manual/api/reference/templategroup/object) gehört.|
|selectTemplates|query|Vorlagen zurückgeben, mit denen die angegebene Vorlage in der Eigenschaft [`templates`](/manual/api/reference/template/object) verknüpft ist.<br><br>Unterstützt `count`.|
|selectParentTemplates|query|Vorlagen zurückgeben, die mit der angegebenen Vorlage in der Eigenschaft `parentTemplates` verknüpft sind.<br><br>Unterstützt `count`.|
|selectHttpTests|query|Die Webszenarien aus der Vorlage in der Eigenschaft [`httpTests`](/manual/api/reference/httptest/object) zurückgeben.<br><br>Unterstützt `count`.|
|selectItems|query|Die Datenpunkte aus der Vorlage in der Eigenschaft [`items`](/manual/api/reference/item/object) zurückgeben.<br><br>Unterstützt `count`.|
|selectDiscoveries|query|Low-Level-Discoveries aus der Vorlage in der Eigenschaft `discoveries` zurückgeben.<br><br>Unterstützt `count`.|
|selectTriggers|query|Die Auslöser aus der Vorlage in der Eigenschaft [`triggers`](/manual/api/reference/trigger/object) zurückgeben.<br><br>Unterstützt `count`.|
|selectGraphs|query|Die Diagramme aus der Vorlage in der Eigenschaft [`graphs`](/manual/api/reference/graph/object) zurückgeben.<br><br>Unterstützt `count`.|
|selectMacros|query|Die Makros aus der Vorlage in der Eigenschaft [`macros`](/manual/api/reference/usermacro/object#host-macro) zurückgeben.|
|selectDashboards|query|Die Dashboards aus der Vorlage in der Eigenschaft [`dashboards`](/manual/api/reference/templatedashboard/object) zurückgeben.<br><br>Unterstützt `count`.|
|selectValueMaps|query|Eine Eigenschaft [`valuemaps`](/manual/api/reference/valuemap/object) mit Vorlagen-Wertzuordnungen zurückgeben.|
|limitSelects|integer|Begrenzt die Anzahl der von Unterabfragen zurückgegebenen Datensätze.<br><br>Gilt für die folgenden Unterabfragen:<br>`selectTemplates` - Ergebnisse werden nach `name` sortiert;<br>`selectHosts` - sortiert nach `host`;<br>`selectParentTemplates` - sortiert nach `host`;<br>`selectItems` - sortiert nach `name`;<br>`selectDiscoveries` - sortiert nach `name`;<br>`selectTriggers` - sortiert nach `description`;<br>`selectGraphs` - sortiert nach `name`;<br>`selectDashboards` - sortiert nach `name`.|
|sortfield|string/array|Das Ergebnis nach den angegebenen Eigenschaften sortieren.<br><br>Mögliche Werte: `hostid`, `host`, `name`, `status`.|
|countOutput|boolean|Diese Parameter werden in der [Referenzkommentierung](/manual/api/reference_commentary#common-get-method-parameters) beschrieben.|
|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|Dieser Parameter ist veraltet, bitte verwenden Sie stattdessen `selectTemplateGroups`.<br>Die Vorlagengruppen zurückgeben, zu denen die Vorlage in der Eigenschaft [`groups`](/manual/api/reference/templategroup/object) gehört.|

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

[comment]: # ({7223bab1-7223bab1})
### Rückgabewerte

`(integer/array)` Gibt entweder zurück:

-   ein Array von Objekten;
-   die Anzahl der abgerufenen Objekte, wenn der Parameter `countOutput` verwendet wurde.

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

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

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

[comment]: # ({dfae5d3a-7e546e9a})
#### Vorlagen nach Namen abrufen

Rufen Sie alle Daten zu zwei Vorlagen mit den Namen "Linux" und "Windows" ab.

[Anfrage](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "template.get",
    "params": {
        "output": "extend",
        "filter": {
            "host": [
                "Linux",
                "Windows"
            ]
        }
    },
    "id": 1
}
```

Antwort:

```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})
#### Abrufen von Vorlagengruppen

Rufen Sie die Vorlagengruppen ab, deren Mitglied die Vorlage „Linux by Zabbix Agent“ ist.

[Anfrage](/manual/api#performing-requests):

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

Antwort:

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

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

[comment]: # ({ce53b2e1-a8599e09})
#### Hosts nach Vorlage abrufen

Rufen Sie Hosts ab, mit denen die Vorlage „10001“ (*Linux by Zabbix agent*) verknüpft ist.

[Anfrage](/manual/api#performing-requests):

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

Antwort:

```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})
#### Suche nach Vorlagen-Tags

Ruft Vorlagen ab, die das Tag "host-name" mit dem Wert "{HOST.NAME}" haben.

[Anfrage](/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
}
```

Antwort:

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

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

[comment]: # ({a0ef7cf5-ee3fc022})
### Siehe auch

-   [Vorlagengruppe](/manual/api/reference/templategroup/object#template-group)
-   [Vorlage](object#template)
-   [Benutzer
    Makro](/manual/api/reference/usermacro/object#hosttemplate-level-macro)
-   [Host
    Schnittstelle](/manual/api/reference/hostinterface/object#host-interface)

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

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

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

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