这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.
2022 Zabbix中国峰会
2022 Zabbix中国峰会

> 维护模式对象

如下对象与维护模式API关联。

维护

维护对象有如下属性。

属性 类型 描述
maintenanceid string (只读) 维护周期的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 维护期必须生效的日期。

仅用于一个时间段。

给定值将四舍五入为分钟。

默认值:当前日期。
start_time integer 一天中开始维护的时间,以秒为单位。

用于每日、每周和每月的周期。

给定值将向下舍入为分钟。<br >
默认值:0。
every integer 用于每日、每周和每月周期。

对于每日和每周周期,every 定义维护必须生效的天或周间隔。

默认值: 1.

对于月度周期,如果 dayofweek 属性包含至少一个选定的星期几,则 every 属性定义维护必须生效的月份中的星期几。
<br >可能的值:
1 - (默认值) 第一周;
2 - 第二周;
3 - 第三周;
4 - 第四周;
5 - 上周。
dayofweek integer 维护必须生效的星期几。

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

用于每周和每月的时间段。仅对于每周时间段是必需的。

必须为每月时间段指定至少一个“dayofweek”或“day”。
day integer 维护必须生效的月份中的哪一天。

仅用于每月时间段。

必须至少指定一个 dayofweekday每月时间段。
month integer 维护必须生效的月份。

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

仅在每月的时间段内需要。

问题标签

问题标签对象用于定义维护生效时必须抑制哪些问题。它具有以下属性。

属性 类型 描述
tag
(必需)
string 问题标签名字。
operator integer 条件运算符。

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