Documentation
Table of Contents
template.get
Описание
integer/array template.get(параметры объекта)
Этот метод позволяет получать шаблоны в соответствии с заданными параметрами.
Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.
Параметры
(объект) Параметры задают желаемый вывод.
Этот метод поддерживает следующие параметры.
| Параметр | Тип | Описание |
|---|---|---|
| templateids | строка/массив | Возврат шаблонов только с заданными ID шаблонов. |
| groupids | строка/массив | Возврат только тех шаблонов, которые принадлежат заданным группам узлов сети. |
| parentTemplateids | строка/массив | Возврат только тех шаблонов, которые являются дочерними заданным шаблонам. |
| hostids | строка/массив | Возврат только тех шаблонов, которые присоединены к заданным узлам сети. |
| graphids | строка/массив | Возврат только тех шаблонов, которые содержат заданные графики. |
| itemids | строка/массив | Возврат только тех шаблонов, которые содержат заданные элементы данных. |
| triggerids | строка/массив | Возврат только тех шаблонов, которые содержат заданные триггеры. |
| with_items | флаг | Возврат только тех шаблонов, которые имеют элементы данных. |
| with_triggers | флаг | Возврат только тех шаблонов, которые имеют триггеры. |
| with_graphs | флаг | Возврат только тех шаблонов, которые имеют графики. |
| with_httptests | флаг | Возврат только тех шаблонов, которые имеют веб-сценарии. |
| selectGroups | запрос | Возврат групп узлов сети, которым принадлежит шаблон, в свойстве groups. |
| selectHosts | запрос | Возврат узлов сети, которые присоединены к шаблону, в свойстве hosts.Поддерживается count. |
| selectTemplates | запрос | Возврат дочерних шаблонов в свойстве templates.Поддерживается count. |
| selectParentTemplates | запрос | Возврат родительских шаблонов в свойстве parentTemplates.Поддерживается count. |
| selectHttpTests | запрос | Возврат веб-сценариев из шаблона в свойстве httpTests.Поддерживается count. |
| selectItems | запрос | Возврат элементов данных из шаблона в свойстве items.Поддерживается count. |
| selectDiscoveries | запрос | Возврат низкоуровневых обнаружений из шаблона в свойстве discoveries.Поддерживается count. |
| selectTriggers | запрос | Возврат триггеров из шаблона в свойстве triggers.Поддерживается count. |
| selectGraphs | запрос | Возврат графиков из шаблона в свойстве graphs.Поддерживается count. |
| selectApplications | запрос | Возврат групп элементов данных из шаблона в свойстве applications.Поддерживается count. |
| selectMacros | запрос | Возврат макросов из шаблона в свойстве macros. |
| selectScreens | запрос | Возврат комплексных экранов из шаблона в свойстве screens.Поддерживается count. |
| limitSelects | целое число | Ограничение количества записей, возвращаемых подзапросами. Применимо только к следующим подзапросам: selectTemplates - результаты сортируются по name;selectHosts - сортируются по host;selectParentTemplates - сортируются по host;selectItems - сортируются по name;selectDiscoveries - сортируются по name;selectTriggers - сортируются по description;selectGraphs - сортируются по name;selectApplications - сортируются по name;selectScreens - сортируются по name. |
| sortfield | строка/массив | Сортировка результата в соответствии с заданными свойствами. Возможные значения: hostid, host, name, status. |
| countOutput | логический | Эти параметры являются общими для всех методов get и они описаны в справочных комментариях. |
| editable | логический | |
| excludeSearch | логический | |
| filter | объект | |
| limit | целое число | |
| output | запрос | |
| preservekeys | логический | |
| search | объект | |
| searchByAny | логический | |
| searchWildcardsEnabled | логический | |
| sortorder | строка/массив | |
| startSearch | логический |
Возвращаемые значения
(целое число/массив) Возвращает либо:
- · массив объектов;
- · количество извлеченных объектов, если использовался параметр
countOutput.
Примеры
Получение шаблонов по имени
Получение всех данных о двух шаблонах с именами "Template OS Linux" и "Template OS Windows".
Запрос:
{
"jsonrpc": "2.0",
"method": "template.get",
"params": {
"output": "extend",
"filter": {
"host": [
"Template OS Linux",
"Template OS Windows"
]
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Ответ:
{
"jsonrpc": "2.0",
"result": [
{
"proxy_hostid": "0",
"host": "Template OS 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": "Template OS Linux",
"flags": "0",
"templateid": "10001",
"description": "",
"tls_connect": "1",
"tls_accept": "1",
"tls_issuer": "",
"tls_subject": "",
"tls_psk_identity": "",
"tls_psk": ""
},
{
"proxy_hostid": "0",
"host": "Template OS 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": "Template OS Windows",
"flags": "0",
"templateid": "10081",
"description": "",
"tls_connect": "1",
"tls_accept": "1",
"tls_issuer": "",
"tls_subject": "",
"tls_psk_identity": "",
"tls_psk": ""
}
],
"id": 1
}Retrieving template groups
Retrieve template groups that the template "Linux by Zabbix agent" is a member of.
{
"jsonrpc": "2.0",
"method": "template.get",
"params": {
"output": ["hostid"],
"selectTemplateGroups": "extend",
"filter": {
"host": [
"Linux by Zabbix agent"
]
}
},
"id": 1
}Response:
{
"jsonrpc": "2.0",
"result": [
{
"templateid": "10001",
"templategroups": [
{
"groupid": "10",
"name": "Templates/Operating systems",
"uuid": "846977d1dfed4968bc5f8bdb363285bc"
}
]
}
],
"id": 1
}Retrieving hosts by template
Retrieve hosts that have the "10001" (Linux by Zabbix agent) template linked to them.
{
"jsonrpc": "2.0",
"method": "template.get",
"params": {
"output": "templateid",
"templateids": "10001",
"selectHosts": ["hostid", "name"]
},
"id": 1
}Response:
{
"jsonrpc": "2.0",
"result": [
{
"templateid": "10001",
"hosts": [
{
"hostid": "10084",
"name": "Zabbix server"
},
{
"hostid": "10603",
"name": "Host 1"
},
{
"hostid": "10604",
"name": "Host 2"
}
]
}
],
"id": 1
}Смотрите также
Смотрите также
Источник
CTemplate::get() в ui/include/classes/api/services/CTemplate.php.