> 操作 object

以下objects与action API直接相关。

动作

动作 object 具有以下属性。

属性 数据类型 描述
actionid string (只读) 动作的ID。
esc_period
(required)
string 默认操作步骤持续时间。必须至少为 60 秒。接受秒数、带后缀的时间单位和用户宏。

注意,升级仅支持触发器、内部和服务动作,且仅在正常操作中支持。
eventsource
(required)
integer (常量) 动作将处理的事件类型。

有关支持的事件类型列表,请参阅 事件
name
(required)
string 动作的名称。
status integer 动作是启用还是禁用。

可能的值:
0 - (默认) 启用;
1 - 禁用。
pause_suppressed integer 是否在维护期间暂停升级。

可能的值:
0 - 不暂停升级;
1 - (默认) 暂停升级。

注意,此参数仅对触发器动作有效。
notify_if_canceled integer 是否在升级取消时通知。

可能的值:
0 - 升级取消时不通知;
1 - (默认) 升级取消时通知。

注意,此参数仅对触发器动作有效。

注意,对于某些方法(更新、删除),必需/可选参数的组合是不同的。

Action 操作

动作操作object定义了当动作执行时将执行的操作。它具有以下属性。

属性 数据类型 描述
operationid string (只读) 动作操作的ID。
operationtype
(required)
integer 操作类型。

可能的值:
0 - 发送消息;
1 - 全局脚本;
2 - 添加主机;
3 - 移除主机;
4 - 添加到主机组;
5 - 从主机组移除;
6 - 链接到模板;
7 - 从模板取消链接;
8 - 启用主机;
9 - 禁用主机;
10 - 设置主机的资产清单模式。

注意,只有类型'0'和'1'支持触发器和服务动作,只有'0'支持内部动作。所有类型都支持发现和自动注册动作。
actionid string (只读) 操作所属的动作ID。
esc_period string 升级步骤的持续时间(秒)。必须大于60秒。接受秒数、带后缀的时间单位和用户宏。如果设置为0或0s,将使用默认的动作升级周期。

默认值:0s。

注意,升级仅支持触发器、内部和服务动作,并且仅在正常操作中支持。
esc_step_from integer 开始升级的步骤。

默认值:1。

注意,升级仅支持触发器、内部和服务动作,并且仅在正常操作中支持。
esc_step_to integer 结束升级的步骤。

默认值:1。

注意,升级仅支持触发器、内部和服务动作,并且仅在正常操作中支持。
evaltype integer 操作条件评估方法。

可能的值:
0 - (默认) AND / OR;
1 - AND;
2 - OR。
opcommand object object包含操作运行的全局脚本数据。

每个object有一个以下属性:scriptid - (string) 脚本的ID。

全局脚本操作必需。
opcommand_grp array 运行全局脚本的主机组。

每个object有以下属性:
opcommand_grpid - (string, 只读) object的ID;
operationid - (string, 只读) 操作的ID;
groupid - (string) 主机组的ID。

全局脚本操作必需,如果未设置opcommand_hst
opcommand_hst array 运行全局脚本的主机。

每个object有以下属性:
opcommand_hstid - (string, 只读) object的ID;
operationid - (string, 只读) 操作的ID;
hostid - (string) 主机的ID;如果设置为0,命令将在当前主机上运行。

全局脚本操作必需,如果未设置opcommand_grp
opconditions array 用于触发器动作的操作条件。

操作条件object是action-操作条件
opgroup array 添加主机的主机组。

每个object有以下属性:
operationid - (string, 只读) 操作的ID;
groupid - (string) 主机组的ID。

"添加到主机组"和"从主机组移除"操作必需。
opmessage object object包含操作发送的消息数据。

操作消息object是action-操作消息

消息操作必需。
opmessage_grp array 发送消息的用户组。

每个object有以下属性:
operationid - (string, 只读) 操作的ID;
usrgrpid - (string) 用户组的ID。

消息操作必需,如果未设置opmessage_usr
opmessage_usr array 发送消息的用户。

每个object有以下属性:
operationid - (string, 只读) 操作的ID;
userid - (string) 用户的ID。

消息操作必需,如果未设置opmessage_grp
optemplate array 链接主机的模板。

每个object有以下属性:
operationid - (string, 只读) 操作的ID;
templateid - (string) 模板的ID。

"链接到模板"和"从模板取消链接"操作必需。
opinventory object 设置主机的资产清单模式。

object有以下属性:
operationid - (string, 只读) 操作的ID;
inventory_mode - (string) 资产清单模式。

"设置主机资产清单模式"操作必需。

Action 操作消息

操作消息object包含有关该操作将发送消息的数据信息。

属性 数据类型 说明
default_msg integer 是否使用默认动作消息文本和主题。

可选值:
0 - 使用操作中的数据;
1 - (默认) 使用媒介类型中的数据。
mediatypeid string 用于发送消息的媒介类型ID。
message string 操作消息文本。
subject string 操作消息主题。

Action 操作条件

操作条件object定义了执行当前操作必须满足的条件。它具有以下属性。

属性 数据类型 描述
opconditionid string (只读) 操作条件的ID
conditiontype
(required)
integer 条件类型。

可能的值:
14 - 事件已确认。
value
(required)
string 用于比较的值。
operationid string (只读) 操作的ID。
operator integer 条件运算符。

可能的值:
0 - (默认) =。

每种操作条件类型支持以下运算符和值。

条件 条件名称 支持的运算符 期望值
14 Event acknowledged = 事件是否已确认。

可能的值:
0 - 未确认;
1 - 已确认。

Action 恢复操作

动作恢复操作object定义了当问题被解决时将执行的操作。恢复操作可用于触发器、内部和服务动作,具有以下属性。

属性 数据类型 描述
operationid string (只读) 动作操作的ID。
operationtype
(required)
integer 操作类型。

触发器和服务动作的可能值:
0 - 发送消息;
1 - 全局脚本;
11 - 通知所有相关人员。

内部动作的可能值:
0 - 发送消息;
11 - 通知所有相关人员。
actionid string (只读) 恢复操作所属动作的ID。
opcommand object object包含操作运行的全局动作类型脚本数据。

每个object具有以下属性:scriptid - (string) 动作类型脚本的ID。

全局脚本操作必需。
opcommand_grp array 运行全局脚本的主机组。

每个object具有以下属性:
opcommand_grpid - (string, 只读) object的ID;
operationid - (string, 只读) 操作的ID;
groupid - (string) 主机组的ID。

如果未设置opcommand_hst,则全局脚本操作必需。
opcommand_hst array 运行全局脚本的主机。

每个object具有以下属性:
opcommand_hstid - (string, 只读) object的ID;
operationid - (string, 只读) 操作的ID;
hostid - (string) 主机的ID;如果设置为0,命令将在当前主机上运行。

如果未设置opcommand_grp,则全局脚本操作必需。
opmessage object object包含恢复操作发送的消息数据。

操作消息object是action-操作消息

消息操作必需。
opmessage_grp array 发送消息的用户组。

每个object具有以下属性:
operationid - (string, 只读) 操作的ID;
usrgrpid - (string) 用户组的ID。

如果未设置opmessage_usr,则消息操作必需。
opmessage_usr array 发送消息的用户。

每个object具有以下属性:
operationid - (string, 只读) 操作的ID;
userid - (string) 用户的ID。

如果未设置opmessage_grp,则消息操作必需。

Action 更新操作

动作更新操作object定义了当问题被更新(添加评论、确认、严重性变更或手动关闭)时执行的操作。更新操作适用于触发器和服务动作,具有以下属性:

属性 数据类型 描述
operationid string (只读) 动作操作ID
operationtype
(required)
integer 操作类型

触发器和服务动作的可能值:
0 - 发送消息;
1 - 全局脚本;
12 - 通知所有相关人员
opcommand object 包含操作执行的全局动作类型脚本数据的object

每个object具有以下属性:scriptid - (string) 动作类型脚本ID

全局脚本操作必需
opcommand_grp array 运行全局脚本的主机组

每个object具有以下属性:
groupid - (string) 主机组ID

当未设置opcommand_hst时,全局脚本操作必需
opcommand_hst array 运行全局脚本的主机

每个object具有以下属性:
hostid - (string) 主机ID;若设为0则命令在当前主机执行

当未设置opcommand_grp时,全局脚本操作必需
opmessage object 包含更新操作发送消息数据的object

操作消息object为action-操作消息
opmessage_grp array 接收消息的用户组

每个object具有以下属性:
usrgrpid - (string) 用户组ID

仅当未设置opmessage_usr时,send message操作必需
send update message操作中忽略此属性
opmessage_usr array 接收消息的用户

每个object具有以下属性:
userid - (string) 用户ID

仅当未设置opmessage_grp时,send message操作必需
send update message操作中忽略此属性

操作过滤器

动作过滤器object定义了一组必须满足的条件才能执行配置的动作操作。它具有以下属性。

属性 数据类型 描述
conditions
(required)
array 用于过滤结果的过滤条件集合。
evaltype
(required)
integer 过滤条件评估方法。

可能的值:
0 - 与/或;
1 - 与;
2 - 或;
3 - 自定义表达式。
eval_formula string (只读) 用于评估过滤条件的生成表达式。该表达式包含通过formulaid引用特定过滤条件的ID。对于具有自定义表达式的过滤器,eval_formula的值等于formula的值。
formula string 用于评估具有自定义表达式的过滤器条件的用户定义表达式。该表达式必须包含通过formulaid引用特定过滤条件的ID。表达式中使用的ID必须与过滤条件中定义的ID完全匹配:不能有任何条件未被使用或省略。

自定义表达式过滤器必需。

Action 过滤条件

动作过滤器条件object定义了在执行动作操作前必须检查的特定条件。

属性 数据类型 描述
conditionid string (只读) 动作条件的ID。
conditiontype
(required)
integer 条件类型。

触发器动作的可能值:
0 - 主机组;
1 - 主机;
2 - 触发器;
3 - 事件名称;
4 - 触发器严重性;
6 - 时间段;
13 - 主机模板;
16 - 问题被抑制;
25 - 事件标签;
26 - 事件标签值。

发现动作的可能值:
7 - 主机 IP;
8 - 发现的服务类型;
9 - 发现的服务端口;
10 - 发现状态;
11 - 运行时间或停机时间;
12 - 接收到的值;
18 - 发现规则;
19 - 发现检查;
20 - proxy;
21 - 发现object。

自动注册动作的可能值:
20 - proxy;
22 - 主机名称;
24 - 主机元数据。

内部动作的可能值:
0 - 主机组;
1 - 主机;
13 - 主机模板;
23 - 事件类型;
25 - 事件标签;
26 - 事件标签值。

服务动作的可能值:
25 - 事件标签;
26 - 事件标签值;
27 - 服务;
28 - 服务名称。
value
(required)
string 用于比较的值。
value2
string 用于比较的次要值。当条件类型为26时,触发器、内部和服务动作需要此值。
actionid string (只读) 条件所属的动作ID。
formulaid string 用于从自定义表达式中引用条件的任意唯一ID。只能包含大写字母。在修改过滤条件时必须由用户定义,但在之后请求时会重新生成。
operator integer 条件运算符。

可能的值:
0 - (默认) 等于;
1 - 不等于;
2 - 包含;
3 - 不包含;
4 - 在;
5 - 大于或等于;
6 - 小于或等于;
7 - 不在;
8 - 匹配;
9 - 不匹配;
10 - 是;
11 - 否。

要更好地了解如何将过滤器与各种类型的表达式一起使用,请参阅检索发现动作使用自定义表达式过滤器方法页面上的示例。

每种条件类型支持以下运算符和值。

条件 条件名称 支持的运算符 期望值
0 Host group equals,
does not equal
主机组ID。
1 Host equals,
does not equal
主机 ID。
2 Trigger equals,
does not equal
触发器ID。
3 Event name contains,
does not contain
事件名称。
4 Trigger severity equals,
does not equal,
is greater than or equals,
is less than or equals
触发器严重性。请参阅触发器以获取支持的触发器严重性列表。
5 Trigger value equals 触发器值。请参阅触发器以获取支持的触发器值列表。
6 Time period in, not in 事件触发的时间,格式为time period
7 Host IP equals,
does not equal
一个或多个以逗号分隔的IP范围。有关支持的IP范围格式的更多信息,请参阅network discovery configuration部分。
8 Discovered service type equals,
does not equal
发现的服务类型。服务类型与用于检测服务的发现检查类型匹配。请参阅发现检查以获取支持的类型列表。
9 Discovered service port equals,
does not equal
一个或多个以逗号分隔的端口范围。
10 Discovery status equals 发现的object的状态。

可能的值:
0 - 主机或服务启动;
1 - 主机或服务关闭;
2 - 主机或服务发现;
3 - 主机或服务丢失。
11 Uptime or downtime duration is greater than or equals,
is less than or equals
表示发现的object处于当前状态的秒数。
12 Received values equals,
does not equal,
is greater than or equals,
is less than or equals,
contains,
does not contain
执行Zabbix agent、SNMPv1、SNMPv2或SNMPv3发现检查时返回的值。
13 Host template equals,
does not equal
链接模板ID。
16 Problem is suppressed Yes, No 不需要值:使用“是”运算符表示问题必须被抑制,“否”表示不被抑制。
18 Discovery rule equals,
does not equal
发现规则的ID。
19 Discovery check equals,
does not equal
发现检查的ID。
20 Proxy equals,
does not equal
proxy的ID。
21 Discovery object equals 触发发现事件的object类型。

可能的值:
1 - 发现的主机;
2 - 发现的服务。
22 Host name contains,
does not contain,
matches,
does not match
主机名称。
在自动注册条件中,对于运算符匹配不匹配,支持使用正则表达式。
23 Event type equals 特定的内部事件。

可能的值:
0 - 监控项处于“不支持”状态;
1 - 监控项处于“正常”状态;
2 - LLD规则处于“不支持”状态;
3 - LLD规则处于“正常”状态;
4 - 触发器处于“未知”状态;
5 - 触发器处于“正常”状态。
24 Host metadata contains,
does not contain,
matches,
does not match
自动注册的主机的元数据。
对于运算符匹配不匹配,支持使用正则表达式。
25 Tag equals,
does not equal,
contains,
does not contain
事件标签。
26 Tag value equals,
does not equal,
contains,
does not contain
事件标签值。
27 Service equals,
does not equal
服务ID。
28 Service name equals,
does not equal
服务名称。