维护期对象

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

维护

维护对象有如下属性。

属性类型描述
maintenanceidID维护周期的ID。

属性行为:
- 只读
- 必需 用于更新操作
namestring维护周期的名称。

属性行为:
- 必需 用于创建操作
active_sincetimestamp维护周期生效的开始时间。

属性行为:
- 必需 用于创建操作
active_tilltimestamp维护周期结束时间。

属性行为:
- 必需 用于创建操作
descriptionstring维护周期说明。
maintenance_typeinteger维护周期类型。

可选值:
0 - (默认) 收集数据;
1 - 不收集数据。
tags_evaltypeinteger问题标签多条件逻辑。

可选值:
0 - (默认) And/Or;
2 - Or.

时间段

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

属性类型说明
periodinteger维护周期的持续时间,以秒为单位。

给定的值将向下舍入为分钟。

默认值: 3600.
timeperiod_typeinteger时间段的类型。

可能的值:
0 - (默认) 仅一次;
2 - 每天;
3 - 每周;
4 - 每月一次。
start_datetimestamp维护期必须生效的日期。
给定值将四舍五入为分钟。

默认值:当前日期。

属性行为:
- 支持 如果”timeperiod_type”设置为”one time only”
start_timeinteger一天中开始维护的时间,以秒为单位。
给定的值将四舍五入到分钟。

默认值: 0.

属性行为:
- 支持 如果 timeperiod_type 设置为 “daily”, “weekly”, 或”monthly”
everyinteger对于每日和每周的周期, every 定义了维护生效的天或周的间隔。
timeperiod_type 设置为”daily”或”weekly”时,默认值为:1。

对于每月的周期,当 day 被设置时,every 属性定义了维护生效的月份中的具体日期。
默认值为1,如果 timeperiod_type 设置为“monthly”并且 day 被设置。

对于每月的周期,当 dayofweek 被设置时,every 属性定义了维护生效的月份中的周。
如果timeperiod_type设置为”monthly”并且dayofweek设置为可能的值:
1 - (默认值) 第一周;
2 - 第二周;
3 - 第三周;
4 - 第四周;
5 - 最后一周.

属性行为:
- 支持 如果 timeperiod_type 设置为 “daily”, “weekly”, 或 “monthly”
dayofweekinteger维护必须生效的星期几。

天以二进制形式存储,每个位代表对应的日期。例如,4 等于二进制的 100,表示维护将在星期三启用。

属性行为:
- 必需 如果 timeperiod_type 设置为 “weekly”, 或如果 timeperiod_type设置为”monthly” 而且 day 未设置
- 支持 如果 timeperiod_type 设置为 “monthly”
dayinteger维护必须生效的月份中的哪一天。

属性行为:
- 必需 如果 timeperiod_type 设置为 “monthly” 同时 dayofweek 未设置
- 支持 如果 timeperiod_type 设置为 “monthly”
monthinteger维护必须生效的月份。

月份以二进制形式存储,每个位代表对应的月份。例如,5 等于二进制的 101,表示维护将在 1 月和 3 月启用。

属性行为:
- 必需 如果timeperiod_type设置为”monthly”

问题标签

问题标签对象用于定义维护生效时必须抑制哪些问题。 只有当Maintenance object的“maintenance_type”设置为“with data collection”时,才能指定标签。 它具有以下属性。 |属性|类型|描述| |—|—|———| |tag|string|问题标签名字。

属性行为:
- 必需| |operator|条件运算符。

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