Documentation
维护 object
以下 objects 与 maintenance API 直接相关。
维护
维护 object 具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| maintenanceid | ID | 维护的ID。 属性行为: - 只读 - 必需的 用于 update 操作 |
| name | string | 维护的名称。 属性行为: - 必需的 用于 create 操作 |
| active_since | timestamp | 维护开始生效的时间。 给定的值将向下取整到分钟。 属性行为: - 必需的 用于 create 操作 |
| active_till | timestamp | 维护停止生效的时间。 给定的值将向下取整到分钟。 属性行为: - 必需的 用于 create 操作 |
| description | string | 维护的描述。 |
| maintenance_type | integer | 维护类型。 可能的值： 0 - (默认) 带数据采集； 1 - 无数据采集。 |
| tags_evaltype | integer | 问题标签评估方法。 可能的值： 0 - (默认) And/Or； 2 - Or。 |
时间段
时间段 object 用于定义维护必须生效的时段。
它具有以下属性：
| 属性 | 数据类型 | 描述 |
|---|---|---|
| period | integer | 维护周期的持续时间（以秒为单位）。 给定的值将向下舍入到分钟。 默认值：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 设置为“每月”时 必需 |
问题标签
问题标签 object 用于定义维护生效时必须抑制的告警问题。
只有在将 维护 object 的 maintenance_type 设置为 "with data collection" 时，才可以指定标签。
它具有以下属性。