maintenance.create

Описание

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

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

Параметры

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

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

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

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

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

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

Примеры

Создание обслуживания

Создание обслуживания со сбором данных для группы узлов сети "2". Оно должно быть активно с 22.01.2013 до 22.01.2014 и вступать в силу каждое Воскресенье в 18:00 и длится один час.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "maintenance.create",
           "params": {
               "name": "Sunday maintenance",
               "active_since": 1358844540,
               "active_till": 1390466940,
               "groupids": [
                   "2"
               ],
               "timeperiods": [
                   {
                       "timeperiod_type": 3,
                       "every": 1,
                       "dayofweek": 64,
                       "start_time": 64800,
                       "period": 3600
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

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

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

Исходный код

CMaintenance::create() в frontends/php/api/classes/CMaintenance.php.