Documentation
Table of Contents
maintenance.create
Описание
object maintenance.create(объект/массив maintenances)
Этот метод позволяет создавать новые обслуживания.
Этот метод доступен только пользователям с типом доступа Администратор и Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.
Параметры
(объект/массив) Создаваемые обслуживания.
В дополнение к стандартным свойствам обслуживания, этот метод принимает следующие параметры.
| Параметр | Тип | Описание |
|---|---|---|
| groupids (требуется) | массив | ID групп узлов сети, которые должны затрагиваться обслуживанием. |
| hostids (требуется) | массив | ID узлов сети, которые должны затрагиваться обслуживанием. |
| timeperiods (требуется) | массив | Периоды времени обслуживания. |
| tags | массив | Теги проблем. |
По каждому обслуживанию необходимо указать по крайней мере один узел сети или группа узлов сети.
Возвращаемые значения
(объект) Возвращает объект, который содержит ID созданных обслуживаний, указанных в свойстве maintenanceids. Порядок возвращаемых ID совпадает с порядком переданных обслуживаний.
Примеры
Создание обслуживания
Создать со сбором данных для группы узлов сети с идентификатором "2" и с тегами проблем service:mysqld и error. Оно должно быть активно с 22.01.2013 по 22.01.2014, вступая в силу каждое воскресенье в 18:00 и длиться один час.
Запрос:
{ "jsonrpc": "2.0", "method": "maintenance.create", "params": { "name": "Sunday maintenance", "active_since": 1358844540, "active_till": 1390466940, "tags_evaltype": 0, "groups": [ {"groupid": "2"} ], "timeperiods": [ { "period": 3600, "timeperiod_type": 3, "start_time": 64800, "every": 1, "dayofweek": 64 } ], "tags": [ { "tag": "service", "operator": "0", "value": "mysqld" }, { "tag": "error", "operator": "2", "value": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 }Ответ:
Смотрите также
Источник
CMaintenance::create() в ui/include/classes/api/services/CMaintenance.php.