维护 object
以下 objects 与 maintenance API 直接相关。
维护
维护对象具有以下属性。
| Property | Type | Description |
|---|---|---|
| maintenanceid | ID | 维护的 ID。 属性行为: - 只读 - 更新操作时必需 |
| name | string | 维护的名称。 属性行为: - 创建操作时必需 |
| active_since | timestamp | 维护开始生效的时间（含）。 给定值将向下舍入到分钟。 属性行为: - 创建操作时必需 |
| active_till | timestamp | 维护停止生效的时间（不含）。 给定值将向下舍入到分钟。 属性行为: - 创建操作时必需 |
| description | string | 维护的描述。 |
| maintenance_type | integer | 维护类型。 可能的值： 0 - (默认) 采集数据； 1 - 不采集数据。 |
| tags_evaltype | integer | 问题标签的评估方法。 可能的值： 0 - (默认) 与/或； 2 - 或。 |
时间段
time period 对象用于定义维护必须生效的时间段。 它具有以下属性。
| Property | Type | Description |
|---|---|---|
| period | integer | 维护周期的持续时间，单位为秒。 给定值将向下舍入到分钟。 可取范围：300 - 86399940。 默认值：3600。 |
| timeperiod_type | integer | 时间段类型。 可取值： 0 - (默认) 仅一次； 2 - 每日； 3 - 每周； 4 - 每月。 |
| start_date | timestamp | 维护周期必须生效的日期。 给定值将向下舍入到分钟。 默认值：当前日期。 Property behavior： - supported 如果 timeperiod_type 设置为 "one time only" |
| start_time | integer | 维护开始的当天时间，单位为秒。 给定值将向下舍入到分钟。 默认值：0。 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： - supported 如果 timeperiod_type 设置为 "daily", "weekly", 或 "monthly" |
| dayofweek | integer | 维护必须生效的星期几。 可用位图值： 1 - 星期一； 2 - 星期二； 4 - 星期三； 8 - 星期四； 16 - 星期五； 32 - 星期六； 64 - 星期日。 这是一个位掩码字段；任何可用位图值的总和都可接受（例如，21 表示星期一、星期三和星期五）。 Property behavior： - required 如果 timeperiod_type 设置为 "weekly" 或者 timeperiod_type 设置为 "monthly" 且未设置 day |
| day | integer | 维护必须生效的每月日期。 Property behavior： - required 如果 timeperiod_type 设置为 "monthly" 且未设置 dayofweek |
| month | integer | 维护必须生效的月份。 可用位图值： 1 - 一月； 2 - 二月； 4 - 三月； 8 - 四月； 16 - 五月； 32 - 六月； 64 - 七月； 128 - 八月； 256 - 九月； 512 - 十月； 1024 - 十一月； 2048 - 十二月。 这是一个位掩码字段；任何可用位图值的总和都可接受（例如，585 表示一月、四月、七月和十月）。 Property behavior： - required 如果 timeperiod_type 设置为 "monthly" |
问题标签
问题标签对象用于定义在维护生效时必须抑制哪些问题。
只有当 Maintenance object 的 maintenance_type 设置为“with data collection”时，才能指定标签。
它具有以下属性。
| Property | Type | Description |
|---|---|---|
| tag | string | 问题标签名称。 Property behavior: - required |
| operator | integer | 条件 operator。 Possible values: 0 - 等于； 2 - (default) 包含。 |
| value | string | 问题标签值。 |