maintenance.update

Описание

object maintenance.update(объект/массив maintenances)

Этот метод позволяет обновлять существующие обслуживания.

Этот метод доступен только пользователям с типом доступа Администратор и Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(объект/массив) Свойства обслуживаний, которые будут обновлены.

Свойство maintenanceid должно быть указано по каждому обслуживанию, все остальные свойства опциональны. Будут обновлены только переданные свойства, все остальные останутся неизменными.

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

Параметр	Тип	Описание
groupids	массив	ID групп узлов сети, которые заменят текущие группы.
hostids	массив	ID узлов сети, которые заменят текущие узлы сети.
timeperiods	массив	Периоды времени обслуживания, которые заменят текущие периоды.
tags	массив	Теги проблем.

По каждому обслуживанию необходимо указать по крайней мере один узел сети или группа узлов сети.

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

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

Примеры

Назначение других узлов сети

Замена узлов сети, которые в данный момент назначены обслуживанию "3", двумя другими.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "maintenance.update",
           "params": {
               "maintenanceid": "3",
               "hostids": [
                   "10085",
                   "10084"
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "maintenanceids": [
                   "3"
               ]
           },
           "id": 1
       }

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

Период времени

Источник

CMaintenance::update() в ui/include/classes/api/services/CMaintenance.php.

Documentation