维护期对象
如下对象与维护期API关联。
维护
维护对象具有以下属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| 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。 |
时间段
时间段对象用于定义维护生效的时间段。 它具有以下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| 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 设置为“采集数据”时，才能指定标签。
它具有以下属性。