这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

维护期对象

如下对象与维护期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 维护周期的持续时间,以秒为单位。

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

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

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

默认值:当前日期。

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

默认值: 0.

属性行为:
- 支持 如果 timeperiod_type 设置为 "daily", "weekly", 或"monthly"
every integer 对于每日和每周的周期, 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"
dayofweek integer 维护必须生效的星期几。

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

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

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

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

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

问题标签

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

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

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