[comment]: # aside: 1
[comment]: # ({66e4c1be-c9539601})
# Объект обслуживания
Следующие объекты напрямую связаны с API `maintenance`.
[comment]: # ({/66e4c1be-c9539601})
[comment]: # ({e31fd204-6c1a70bc})
### Обслуживание
Объект обслуживания имеет следующие свойства.
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|maintenanceid|ID|ID обслуживания.
[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *только для чтения*
- *обязательно* для операций обновления|
|name|string|Имя обслуживания.
[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *обязательно* для операций создания|
|active\_since|timestamp|Время, когда обслуживание становится активным (включительно).
Указанное значение будет округлено вниз до минут.
[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *обязательно* для операций создания|
|active\_till|timestamp|Время, когда обслуживание перестает быть активным (исключительно).
Указанное значение будет округлено вниз до минут.
[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *обязательно* для операций создания|
|description|string|Описание обслуживания.|
|maintenance\_type|integer|Тип обслуживания.
Возможные значения:
0 - *(по умолчанию)* с сбором данных;
1 - без сбора данных.|
|tags\_evaltype|integer|Метод [оценки](/manual/maintenance#configuration) тегов проблемы.
Возможные значения:
0 - *(по умолчанию)* And/Or;
2 - Or.|
[comment]: # ({/e31fd204-6c1a70bc})
[comment]: # ({b0bb932e-506f52aa})
### Период времени
Объект периода времени используется для определения периодов, когда обслуживание должно вступить в силу.
Он имеет следующие свойства.
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|period|integer|Длительность периода обслуживания в секундах.
Указанное значение будет округлено вниз до минут.
Допустимый диапазон значений: 300 - 86399940.
По умолчанию: 3600.|
|timeperiod\_type|integer|Тип периода времени.
Возможные значения:
0 - *(по умолчанию)* только один раз;
2 - ежедневно;
3 - еженедельно;
4 - ежемесячно.|
|start\_date|timestamp|Дата, когда период обслуживания должен вступить в силу.
Указанное значение будет округлено вниз до минут.
По умолчанию: текущая дата.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *supported* если `timeperiod_type` установлено в "one time only"|
|start\_time|integer|Время суток, когда обслуживание начинается, в секундах.
Указанное значение будет округлено вниз до минут.
По умолчанию: 0.
[Property behavior](/manual/api/reference_commentary#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](/manual/api/reference_commentary#property-behavior):
- *supported* если `timeperiod_type` установлено в "daily", "weekly" или "monthly"|
|dayofweek|integer|Дни недели, когда обслуживание должно вступить в силу.
Возможные битовые значения:
1 - понедельник;
2 - вторник;
4 - среда;
8 - четверг;
16 - пятница;
32 - суббота;
64 - воскресенье.
Это поле является битовой маской; допустима любая сумма возможных битовых значений (например, 21 для понедельника, среды и пятницы).
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* если `timeperiod_type` установлено в "weekly" или если `timeperiod_type` установлено в "monthly" и `day` не задан|
|day|integer|День месяца, когда обслуживание должно вступить в силу.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* если `timeperiod_type` установлено в "monthly" и `dayofweek` не задан|
|month|integer|Месяцы, когда обслуживание должно вступить в силу.
Возможные битовые значения:
1 - январь;
2 - февраль;
4 - март;
8 - апрель;
16 - май;
32 - июнь;
64 - июль;
128 - август;
256 - сентябрь;
512 - октябрь;
1024 - ноябрь;
2048 - декабрь.
Это поле является битовой маской; допустима любая сумма возможных битовых значений (например, 585 для января, апреля, июля и октября).
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* если `timeperiod_type` установлено в "monthly"|
[comment]: # ({/b0bb932e-506f52aa})
[comment]: # ({da08e754-2913a3ae})
### Тег проблемы
Объект тега проблемы используется для определения, какие проблемы должны быть подавлены, когда вступает в силу обслуживание.
Теги можно указывать только в том случае, если `maintenance_type` объекта [Maintenance](#maintenance) установлен в "with data collection".
Он имеет следующие свойства.
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Имя тега проблемы.
[Поведение свойства](/manual/api/reference_commentary#property-behavior):
- *required*|
|operator|integer|[Оператор](/manual/maintenance#configuration) условия.
Возможные значения:
0 - Равно;
2 - *(по умолчанию)* Содержит.|
|value|string|Значение тега проблемы.|
[comment]: # ({/da08e754-2913a3ae})