Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

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 hosts by template

Retrieve hosts that have the "10001" (Linux by Zabbix agent) template linked to them.

Request:

{
           "jsonrpc": "2.0",
           "method": "template.get",
           "params": {
               "output": "templateid",
               "templateids": "10001",
               "selectHosts": ["hostid", "name"]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "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.