Documentation
维护期对象
如下对象与维护期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|问题标签值。|