Documentation
Table of Contents
maintenance.create
Описание
объект maintenance.create(объект/массив maintenances)
Этот метод позволяет создавать новые обслуживания.
Этот метод доступен для пользователей Admin и Super admin. Разрешения на вызов метода могут быть отозваны в настройках роли пользователя. Смотрите Роли пользователя для получения дополнительной информации.
Параметры
(объект/массив) Создаваемые обслуживания.
В дополнение к стандартным свойствам обслуживания, этот метод принимает следующие параметры.
| Параметр | Тип | Описание |
|---|---|---|
| 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.