Объект обслуживания

Следующие объекты напрямую связаны с API maintenance.

Обслуживание

Объект обслуживания имеет следующие свойства.

Свойство Тип Описание
maintenanceid ID ID обслуживания.

Поведение свойства:
- только для чтения
- обязательно для операций обновления
name string Имя обслуживания.

Поведение свойства:
- обязательно для операций создания
active_since timestamp Время, когда обслуживание становится активным (включительно).

Указанное значение будет округлено вниз до минут.

Поведение свойства:
- обязательно для операций создания
active_till timestamp Время, когда обслуживание перестает быть активным (не включительно).

Указанное значение будет округлено вниз до минут.

Поведение свойства:
- обязательно для операций создания
description string Описание обслуживания.
maintenance_type integer Тип обслуживания.

Возможные значения:
0 - (по умолчанию) со сбором данных;
1 - без сбора данных.
tags_evaltype integer Метод вычисления тегов проблем.

Возможные значения:
0 - (по умолчанию) И/Или;
2 - Или.

Период времени

Объект периода времени используется для определения периодов, когда обслуживание должно вступать в силу. Он имеет следующие свойства.

Свойство Type Описание
period integer Длительность периода обслуживания в секундах.

Указанное значение будет округлено вниз до минут.

Допустимый диапазон значений: 300 - 86399940.

По умолчанию: 3600.
timeperiod_type integer Тип периода времени.

Возможные значения:
0 - (по умолчанию) только один раз;
2 - ежедневно;
3 - еженедельно;
4 - ежемесячно.
start_date timestamp Дата, когда период обслуживания должен вступить в силу.
Указанное значение будет округлено вниз до минут.

По умолчанию: текущая дата.

Поведение свойства:
- поддерживается, если timeperiod_type установлен в "только один раз"
start_time integer Время суток, когда начинается обслуживание, в секундах.
Указанное значение будет округлено вниз до минут.

По умолчанию: 0.

Поведение свойства:
- поддерживается, если timeperiod_type установлен в "ежедневно", "еженедельно" или "ежемесячно"
every integer Для ежедневных и еженедельных периодов every определяет интервалы в днях или неделях, с которыми обслуживание должно вступать в силу.
Значение по умолчанию, если timeperiod_type установлен в "ежедневно" или "еженедельно": 1.

Для ежемесячных периодов, когда задан day, свойство every определяет день месяца, когда обслуживание должно вступать в силу.
Значение по умолчанию, если timeperiod_type установлен в "ежемесячно" и задан day: 1.

Для ежемесячных периодов, когда задан dayofweek, свойство every определяет неделю месяца, когда обслуживание должно вступать в силу.
Возможные значения, если timeperiod_type установлен в "ежемесячно" и задан dayofweek:
1 - (по умолчанию) первая неделя;
2 - вторая неделя;
3 - третья неделя;
4 - четвертая неделя;
5 - последняя неделя.

Поведение свойства:
- поддерживается, если timeperiod_type установлен в "ежедневно", "еженедельно" или "ежемесячно"
dayofweek integer Дни недели, когда обслуживание должно вступать в силу.

Возможные значения битовой маски:
1 - понедельник;
2 - вторник;
4 - среда;
8 - четверг;
16 - пятница;
32 - суббота;
64 - воскресенье.

Это поле битовой маски; допустима любая сумма возможных значений битовой маски (например, 21 для понедельника, среды и пятницы).

Поведение свойства:
- обязательно, если timeperiod_type установлен в "еженедельно" или если timeperiod_type установлен в "ежемесячно" и day не задан
day integer День месяца, когда обслуживание должно вступать в силу.

Поведение свойства:
- обязательно, если timeperiod_type установлен в "ежемесячно" и dayofweek не задан
month integer Месяцы, когда обслуживание должно вступать в силу.

Возможные значения битовой маски:
1 - январь;
2 - февраль;
4 - март;
8 - апрель;
16 - май;
32 - июнь;
64 - июль;
128 - август;
256 - сентябрь;
512 - октябрь;
1024 - ноябрь;
2048 - декабрь.

Это поле битовой маски; допустима любая сумма возможных значений битовой маски (например, 585 для января, апреля, июля и октября).

Поведение свойства:
- обязательно, если timeperiod_type установлен в "ежемесячно"

Тег проблемы

Объект тега проблемы используется для определения того, какие проблемы должны быть подавлены, когда обслуживание вступает в силу. Теги можно указывать только если maintenance_type объекта обслуживания установлен в значение "with data collection". Он имеет следующие свойства.

Свойство Type Описание
tag string Имя тега проблемы.

Поведение свойства:
- обязательно
operator integer Оператор условия.

Возможные значения:
0 - Равно;
2 - (по умолчанию) Содержит.
value string Значение тега проблемы.