[comment]: # ({896915aa-896915aa})
# template.get
[comment]: # ({/896915aa-896915aa})
[comment]: # ({808af69c-4e400711})
### Descrizione
`integer/array template.get(object parameters)`
Il metodo consente di recuperare i template in base ai parametri
specificati.
::: noteclassic
Questo metodo è disponibile per utenti di qualsiasi tipo. Le autorizzazioni
per chiamare il metodo possono essere revocate nelle impostazioni dei ruoli utente. Per ulteriori informazioni, vedere [Ruoli utente](/manual/web_interface/frontend_sections/users/user_roles).
:::
[comment]: # ({/808af69c-4e400711})
[comment]: # ({bba4c1f2-97f0e40b})
### Parametri
`(object)` Parametri che definiscono l'output desiderato.
Il metodo supporta i seguenti parametri.
|Parametro|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|templateids|ID/array|Restituisce solo i template con i template ID specificati.|
|groupids|ID/array|Restituisce solo i template che appartengono ai gruppi di template specificati.|
|parentTemplateids|ID/array|Restituisce solo i template a cui il template specificato è collegato.|
|hostids|ID/array|Restituisce solo i template collegati agli host/template specificati.|
|graphids|ID/array|Restituisce solo i template che contengono i grafici specificati.|
|itemids|ID/array|Restituisce solo i template che contengono gli item specificati.|
|triggerids|ID/array|Restituisce solo i template che contengono i trigger specificati.|
|with\_items|flag|Restituisce solo i template che hanno item.|
|with\_triggers|flag|Restituisce solo i template che hanno trigger.|
|with\_graphs|flag|Restituisce solo i template che hanno grafici.|
|with\_httptests|flag|Restituisce solo i template che hanno scenari web.|
|evaltype|integer|Metodo di [valutazione dei tag](/manual/web_interface/frontend_sections/data_collection/hosts#using-filter).
Valori possibili:
0 - *(predefinito)* And/Or;
2 - Or.|
|tags|object/array|Restituisce solo i template con i tag specificati.
Formato: `[{"tag": "", "value": "", "operator": ""}, ...]`.
Un array vuoto restituisce tutti i template.
Valori possibili di [operator](/manual/web_interface/frontend_sections/data_collection/hosts#using-filter):
0 - *(predefinito)* Contiene;
1 - Uguale a;
2 - Non contiene;
3 - Diverso da;
4 - Esiste;
5 - Non esiste.|
|selectTags|query|Restituisce i tag del template nella proprietà [`tags`](/manual/api/reference/template/object#template-tag).|
|selectDiscoveryRules|query|Restituisce una proprietà [`discoveryRules`](/manual/api/reference/discoveryrule/object) con le regole LLD del template.
Supporta `count`.|
|selectHosts|query|Restituisce gli host collegati al template nella proprietà [`hosts`](/manual/api/reference/host/object).
Supporta `count`.|
|selectTemplateGroups|query|Restituisce i gruppi di template a cui appartiene il template nella proprietà [`templategroups`](/manual/api/reference/templategroup/object).|
|selectTemplates|query|Restituisce i template a cui è collegato il template specificato nella proprietà [`templates`](/manual/api/reference/template/object).
Supporta `count`.|
|selectParentTemplates|query|Restituisce i template collegati al template specificato nella proprietà `parentTemplates`.
Supporta `count`.|
|selectHttpTests|query|Restituisce gli scenari web del template nella proprietà [`httpTests`](/manual/api/reference/httptest/object).
Supporta `count`.|
|selectItems|query|Restituisce gli item del template nella proprietà [`items`](/manual/api/reference/item/object).
Supporta `count`.|
|selectTriggers|query|Restituisce i trigger del template nella proprietà [`triggers`](/manual/api/reference/trigger/object).
Supporta `count`.|
|selectGraphs|query|Restituisce i grafici del template nella proprietà [`graphs`](/manual/api/reference/graph/object).
Supporta `count`.|
|selectMacros|query|Restituisce le macro del template nella proprietà [`macros`](/manual/api/reference/usermacro/object#host-macro).|
|selectDashboards|query|Restituisce i dashboard del template nella proprietà [`dashboards`](/manual/api/reference/templatedashboard/object).
Supporta `count`.|
|selectValueMaps|query|Restituisce una proprietà [`valuemaps`](/manual/api/reference/valuemap/object) con le mappe dei valori del template.|
|limitSelects|integer|Limita il numero di record restituiti dalle sottoquery.
Si applica alle seguenti sottoquery:
`selectTemplates` - i risultati saranno ordinati per `name`;
`selectHosts` - ordinati per `host`;
`selectParentTemplates` - ordinati per `host`;
`selectItems` - ordinati per `name`;
`selectDiscoveryRules` - ordinati per `name`;
`selectTriggers` - ordinati per `description`;
`selectGraphs` - ordinati per `name`;
`selectDashboards` - ordinati per `name`.|
|sortfield|string/array|Ordina il risultato in base alle proprietà specificate.
Valori possibili: `hostid`, `host`, `name`, `status`.|
|countOutput|boolean|Questi parametri sono descritti nel [commento di riferimento](/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|Restituisce le low-level discovery del template nella proprietà `discoveries`.
Supporta `count`.
Questa query è **deprecata**; usare invece `selectDiscoveryRules`.|
[comment]: # ({/bba4c1f2-97f0e40b})
[comment]: # ({7223bab1-7223bab1})
### Valori restituiti
`(integer/array)` Restituisce uno dei seguenti:
- un array di oggetti;
- il numero di oggetti recuperati, se è stato utilizzato il parametro `countOutput`.
[comment]: # ({/7223bab1-7223bab1})
[comment]: # ({b41637d2-b41637d2})
### Esempi
[comment]: # ({/b41637d2-b41637d2})
[comment]: # ({418c03b3-7e546e9a})
#### Recupero dei template per nome
Recupera tutti i dati relativi a due template denominati "Linux" e "Windows".
[Richiesta](/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
}
```
Risposta:
```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": "Questo è un template ufficiale per Linux. Richiede Zabbix agent 7.4 o versioni successive.\r\n\r\nNote sulla discovery del filesystem (FS):\r\n- Il filesystem ext4/3/2 riserva spazio per l'uso privilegiato, in genere impostato al 5% per impostazione predefinita.\r\n- BTRFS assegna per impostazione predefinita il 10% del volume alle proprie esigenze.\r\n- Per mitigare potenziali disastri, i trigger di utilizzo del FS si basano sullo spazio massimo disponibile.\r\n - Formula di utilizzo: 'pused = 100 - 100 * (available / total - free + available)'\r\n- Il grafico di utilizzo del FS, derivato dai prototipi di grafico, riflette lo spazio riservato del FS come differenza tra lo spazio usato e quello disponibile rispetto al volume totale.\r\n\r\nPuoi discutere questo template o lasciare un feedback nel nostro forum https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/387225-discussion-thread-for-official-zabbix-template-for-linux\r\n\r\nGenerato dallo strumento ufficiale per template di 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": "## Panoramica\r\n\r\nQuesto è un template ufficiale per Linux. Richiede Zabbix agent 7.4 o versioni successive.\r\n\r\n#### Note sulla discovery del filesystem (FS):\r\n- Il filesystem ext4/3/2 riserva spazio per l'uso privilegiato, in genere impostato al 5% per impostazione predefinita.\r\n- BTRFS assegna per impostazione predefinita il 10% del volume alle proprie esigenze.\r\n- Per mitigare potenziali disastri, i trigger di utilizzo del FS si basano sullo spazio massimo disponibile.\r\n - Formula di utilizzo: `pused = 100 - 100 * (available / total - free + available)`\r\n- Il grafico di utilizzo del FS, derivato dai prototipi di grafico, riflette lo spazio riservato del FS come differenza tra lo spazio usato e quello disponibile rispetto al volume totale."
},
{
"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": "Questo è un template ufficiale per Windows. Richiede Zabbix agent 7.4 o versioni successive.\r\n\r\nPuoi discutere questo template o lasciare un feedback nel nostro forum https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/387224-discussion-thread-for-official-zabbix-template-for-windows\r\n\r\nGenerato dallo strumento ufficiale per template di 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": "## Panoramica\r\n\r\nQuesto è un template ufficiale per Windows. Richiede Zabbix agent 7.4 o versioni successive."
}
],
"id": 1
}
```
[comment]: # ({/418c03b3-7e546e9a})
[comment]: # ({4e2a2df6-84d0cbf3})
#### Recupero dei gruppi di template
Recupera i gruppi di template di cui il template "Linux by Zabbix agent" è membro.
[Request](/manual/api#performing-requests):
```json
{
"jsonrpc": "2.0",
"method": "template.get",
"params": {
"output": ["hostid"],
"selectTemplateGroups": "extend",
"filter": {
"host": [
"Linux by Zabbix agent"
]
}
},
"id": 1
}
```
Risposta:
```json
{
"jsonrpc": "2.0",
"result": [
{
"templateid": "10001",
"templategroups": [
{
"groupid": "10",
"name": "Templates/Operating systems",
"uuid": "846977d1dfed4968bc5f8bdb363285bc"
}
]
}
],
"id": 1
}
```
[comment]: # ({/4e2a2df6-84d0cbf3})
[comment]: # ({ce53b2e1-a8599e09})
#### Recupero degli host per template
Recupera gli host a cui è collegato il template "10001" (*Linux by Zabbix agent*).
[Richiesta](/manual/api#performing-requests):
```json
{
"jsonrpc": "2.0",
"method": "template.get",
"params": {
"output": "templateid",
"templateids": "10001",
"selectHosts": ["hostid", "name"]
},
"id": 1
}
```
Risposta:
```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})
#### Ricerca per tag del template
Recupera i template che hanno il tag "host-name" uguale a "{HOST.NAME}".
[Richiesta](/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
}
```
Risposta:
```json
{
"jsonrpc": "2.0",
"result": [
{
"hostid": "10402",
"tags": [
{
"tag": "host-name",
"value": "{HOST.NAME}"
}
]
}
],
"id": 1
}
```
[comment]: # ({/3380e3c0-0fe2d603})
[comment]: # ({45da1f59-ee3fc022})
### Vedi anche
- [Gruppo di template](/manual/api/reference/templategroup/object#template-group)
- [Template](object#template)
- [Macro utente](/manual/api/reference/usermacro/object#hosttemplate-level-macro)
- [Interfaccia host](/manual/api/reference/hostinterface/object#host-interface)
[comment]: # ({/45da1f59-ee3fc022})
[comment]: # ({4fdbde5d-4fdbde5d})
### Fonte
CTemplate::get() in *ui/include/classes/api/services/CTemplate.php*.
[comment]: # ({/4fdbde5d-4fdbde5d})