维护 object

以下objects与maintenanceAPI直接相关.

维护

维护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 - (默认) 与/或;
2 - 或.

时间段

时间段 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用于定义当维护生效时需要抑制哪些问题。 仅当维护objectmaintenance_type设置为"with data collection"时才能指定标签。 它具有以下属性。

属性 数据类型 描述
tag string 问题标签名称。

属性行为:
- 必填
operator integer 条件运算符。

可能值:
0 - 等于;
2 - (默认) 包含。
value string 问题标签值。