维护期对象

如下对象与维护期API关联。

维护

维护对象具有以下属性。

Property Type Description
maintenanceid ID 维护的 ID。

Property behavior:
- read-only
- required for update operations
name string 维护名称。

Property behavior:
- required for create operations
active_since timestamp 维护开始生效的时间（包含）。

给定值将向下舍入到分钟。

Property behavior:
- required for create operations
active_till timestamp 维护停止生效的时间（不包含）。

给定值将向下舍入到分钟。

Property behavior:
- required for create operations
description string 维护说明。
maintenance_type integer 维护类型。

可能的值：
0 - (default) with data collection;
1 - without data collection.
tags_evaltype integer 问题标签的评估方法。

可能的值：
0 - (default) And/Or;
2 - Or.

时间段

时间段对象用于定义维护生效的时间段。 它具有以下属性。

属性 类型 描述
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 对象 的 maintenance_type 设置为“with data collection”时，才能指定标签。 它具有以下属性。

Property Type Description
tag string 问题标签名称。

Property behavior:
- required
operator integer 条件 operator。

Possible values:
0 - 等于；
2 - (default) 包含。
value string 问题标签值。