template.massupdate

Описание

объект template.massupdate(параметры объекта)

Этот метод позволяет заменить или удалить связанные объекты и обновить свойства сразу на нескольких шаблонах.

Этот метод доступен для пользователей типа Admin и Super admin. Разрешения на вызов метода могут быть отозваны в настройках роли пользователя. Смотрите Роли пользователя для получения дополнительной информации.

Параметры

(объект) Параметры, которые содержат ID обновляемых шаблонов и их свойства, которые необходимо обновить.

В дополнение к стандартным свойствам шаблона, этот метод принимает следующие параметры.

Параметр	Тип	Описание
templates (требуется)	объект/массив	Обновляемые шаблоны. У шаблонов должно быть задано свойство `templateid`.
groups	объект/массив	Группы узлов сети, которые заменят текущие группы узлов сети шаблонов. У групп узлов сети должно быть задано свойство `groupid`.
hosts	объект/массив	Узлы сети и шаблоны, которые заменят текущие присоединенные узлы сети и шаблоны. Как у узлов сети, так и у шаблонов, чтобы указать ID, необходимо использовать свойство `hostid`.
macros	объект/массив	Пользовательские макросы, которые заменят текущие макросы у заданных шаблонов.
templates_clear	объект/массив	Шаблоны, которые необходимо отсоединить и очистить от заданных шаблонов. У шаблонов должно быть задано свойство `templateid`.
templates_link	объект/массив	Шаблоны, которые заменят присоединенные в настоящий момент шаблоны. У шаблонов должно быть задано свойство `templateid`.

Возвращаемые значения

(объект) Возвращает объект, который содержит ID обновленных шаблонов, указанных в свойстве templateids.

Примеры

Unlinking a template

Unlink and clear template "10091" from the given templates.

Request:

{
           "jsonrpc": "2.0",
           "method": "template.massupdate",
           "params": {
               "templates": [
                   {
                       "templateid": "10085"
                   },
                   {
                       "templateid": "10086"
                   }
               ],
               "templates_clear": [
                   {
                       "templateid": "10091"
                   }
               ]
           },
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "templateids": [
                   "10085",
                   "10086"
               ]
           },
           "id": 1
       }

Замена групп узлов сети

Отсоединение и очистка шаблона "10091" с заданных шаблонов.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "template.massupdate",
           "params": {
               "templates": [
                   {
                       "templateid": "10085"
                   },
                   {
                       "templateid": "10086"
                   }
               ],
               "templates_clear": [
                   {
                       "templateid": "10091"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "templateids": [
                   "10085",
                   "10086"
               ]
           },
           "id": 1
       }

Смотрите также

Исходный код

CTemplate::massUpdate() в ui/include/classes/api/services/CTemplate.php.

Documentation