Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

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
       }

Ответ:

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

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

Источник

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