Documentation
Table of Contents
template.update
Описание
объект template.update(объект/массив шаблоны)
Этот метод позволяет обновлять существующие шаблоны.
Параметры
(объект/массив) Свойства шаблонов, которые будут обновлены.
Свойство templateid должно быть указано по каждому шаблону, все остальные свойства опциональны. Будут обновлены только переданные свойства, все остальные останутся неизменными.
В дополнение к стандартным свойствам шаблона, этот метод принимает следующие параметры.
| Параметр | Тип | Описание |
|---|---|---|
| groups | объект/массив | Группы узлов сети, которые заменят текущие группы узлов сети в которые входят шаблоны. У групп узлов сети должно быть задано свойство groupid. |
| tags | объект/массив | Теги шаблона, которые заменят текущие теги шаблона. |
| hosts | объект/массив | Узлы сети и шаблоны, которые заменят текущие присоединенные узлы сети и шаблоны. Как у узлов сети, так и у шаблонов, чтобы указать ID, необходимо использовать свойство hostid. |
| macros | объект/массив | Пользовательские макросы, которые заменят текущие макросы у заданных шаблонов. |
| templates | объект/массив | Шаблоны, которые заменят текущие присоединенные шаблоны. Шаблоны, которые не указаны, будут только отсоединены. У шаблонов должно быть задано свойство templateid. |
| templates_clear | объект/массив | Шаблоны, которые необходимо отсоединить и очистить от заданных шаблонов. У шаблонов должно быть задано свойство templateid. |
Возвращаемые значения
(объект) Возвращает объект, который содержит ID обновленных шаблонов под свойством templateids.
Примеры
Переименование шаблона
Переименование шаблона на "Template OS Linux".
Запрос:
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"name": "Template OS Linux"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Ответ:
Обновление тегов шаблона
Замена всех тегов шаблона на новый тег.
Запрос:
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"tags": [
{
"tag": "Host name",
"value": "{HOST.NAME}"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Ответ:
Исходный код
CTemplate::update() в frontends/php/include/classes/api/services/CTemplate.php.