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

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

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

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

Property Type Description
maintenanceid ID ID обслуживания.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Property behavior:
- supported если timeperiod_type установлено в "one time only"
start_time integer Время суток, когда обслуживание начинается, в секундах.
Указанное значение будет округлено вниз до минут.

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

Property behavior:
- supported если timeperiod_type установлено в "daily", "weekly" или "monthly"
every integer Для ежедневных и еженедельных периодов every определяет интервалы в днях или неделях, через которые обслуживание должно вступить в силу.
Значение по умолчанию, если timeperiod_type установлено в "daily" или "weekly": 1.

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

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

Property behavior:
- supported если timeperiod_type установлено в "daily", "weekly" или "monthly"
dayofweek integer Дни недели, когда обслуживание должно вступить в силу.

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

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

Property behavior:
- required если timeperiod_type установлено в "weekly" или если timeperiod_type установлено в "monthly" и day не задан
day integer День месяца, когда обслуживание должно вступить в силу.

Property behavior:
- required если timeperiod_type установлено в "monthly" и dayofweek не задан
month integer Месяцы, когда обслуживание должно вступить в силу.

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

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

Property behavior:
- required если timeperiod_type установлено в "monthly"

Тег проблемы

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

Property Type Description
tag string Имя тега проблемы.

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

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