maintenance.update

Описание

объект maintenance.update(объект/массив обслуживания)

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

Параметры

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

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

В настоящее время частичное обновление обслуживания не поддерживается, все параметры обязательны. Смотрите ZBX-6167 для получения информации о текущем статусе.

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

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

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

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

(объект) Возвращает объект, который содержит 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() в frontends/php/api/classes/CMaintenance.php.