Documentation
Table of Contents
> Объект обслуживания
Следующие объекты напрямую связаны с API обслуживания (maintenance).
Обслуживание
Объект обслуживания имеет следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| maintenanceid | строка | (только чтение) ID обслуживания. |
| name (требуется) |
строка | Имя обслуживания. |
| active_since (требуется) | штамп времени | Время, когда обслуживание становится активным. |
| active_till (требуется) | штамп времени | Время, когда обслуживание перестает быть активным. |
| description | строка | Описание обслуживания. |
| maintenance_type | целое число | Тип обслуживания. Возможные значения: 0 - (по умолчанию) со сбором данных; 1 - без сбора данных. |
| tags_evaltype | целое число | Метод оценки тегов проблем. Возможные значения: 0 - (по умолчанию) И/Или; 2 - Или. |
Период времени
Объект периода времени используется для определения периодов времени когда обслуживание должно вступить в силу. Этот объект имеет следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| timeperiodid | строка | (только чтение) ID обслуживания. |
| day | целое число | День месяца, когда обслуживание должно вступить в силу. Требуется только для ежемесячных периодов времени. |
| dayofweek | целое число | Дни недели, когда обслуживание должно вступить в силу. Дни хранятся в бинарном виде, где каждый бит представляет собой соответствующий день. Например, 4 соответствует 100 в бинарном виде и означает, что обслуживание будет активным в Среду. Используется только для ежемесячных и еженедельных периодов времени. Требуется только для еженедельных периодов времени. |
| every | целое число | Для ежедневных и ежемесячных периодов every определяет интервалы дня или недели, в которые обслуживание должно вступить в силу.Для ежемесячных периодов every определяет неделю месяца, когда обслуживание должно вступить в силу.Возможные значения: 1 - первая неделя; 2 - вторая неделя; 3 - третья неделя; 4 - четвертая неделя; 5 - последняя неделя. |
| month | целое число | Месяцы, когда обслуживание должно вступить в силу. Месяцы хранятся в бинарном виде, где каждый бит представляет собой соответствующий месяц. Например, 5 соответствует 101 в бинарном виде и означает, что обслуживание будет активным в Январе и Марте. Требуется только для ежемесячных периодов времени. |
| period | целое число | Длительность периода обслуживания в секундах. По умолчанию: 3600. |
| start_date | штамп времени | Дата, когда период обслуживания должен вступить в силу. Требуется только для единовременных периодов времени. По умолчанию: текущее время. |
| start_time | целое число | Время дня, когда начинается обслуживание, в секундах. Требуется для ежедневных, еженедельных и ежемесячных периодов. |
| timeperiod_type | целое число | Тип периода времени. Возможные значения: 0 - (по умолчанию) единовременно; 2 - ежедневно; 3 - еженедельно; 4 - ежемесячно. |
Теги проблем
Объект тегов проблем используется для определения какие проблемы должны быть подавлены, когда обслуживание вступит в силу. Этот объект имеет следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| tag (требуется) |
строка | Тег проблем. |
| operator | целое число | Оператор условий. Возможные значения: 0 - Равно; 2 - (по умолчанию) Содержит. |
| value | строка | Значение тега проблем. |