> 动作对象
以下对象与动作 API 直接相关。
动作
动作对象具有以下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| actionid | 字符 | （只读） 动作 ID。 |
| esc_period （必需） |
字符 | 默认操作步骤持续时间。必须至少为 60 秒。接受秒、带后缀的时间单位和用户宏。 请注意，仅对触发器、内部和服务动作支持升级，问题恢复和更新操作不支持升级。 |
| eventsource （必需） |
整数 | （常量） 动作将处理的事件的类型。 参见 event "source" 属性 以获取支持的事件类型列表。 |
| name （必需） |
字符 | 动作名称。 |
| status | 整数 | 动作是启用还是禁用。 可用值： 0 - （默认） 启用； 1 - 禁用。 |
| pause_suppressed | 整数 | 是否在维护期间暂停升级。 可用值： 0 - 不要暂停升级； 1 - （默认） 暂停升级。 请注意，此参数仅对触发器动作有效。 |
| notify_if_canceled | 整数 | 取消升级时是否通知。 可用值： 0 - 取消升级时不通知； 1 - （默认） 取消升级时通知。 请注意，此参数仅对触发器动作有效。 |
注意，对于某些方法（更新、删除），必需/可选参数组合是不同的。
动作操作
动作操作对象定义执行动作时执行的操作。它具有以下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| operationid | string | （只读）动作操作的 ID。 |
| operationtype （必需） |
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 | 开始升级的 Step 。 默认：1。 请注意，仅触发器、内部和服务操作支持升级，问题恢复和更新操作不支持升级。 |
| esc_step_to | integer | 结束升级的 Step。 默认：1。 请注意，仅触发器、内部和服务操作支持升级，问题恢复和更新操作不支持升级。 |
| evaltype | integer | 操作条件计算方法。 可用值： 0 - （默认） AND / OR； 1 - AND； 2 - OR。 |
| opcommand | object | 对象包含操作运行的全局脚本上的数据。 每个对象具有以下属性： scriptid - （字符串） 脚本的 ID。被全局脚本操作所需要。 |
| opcommand_grp | array | 要在其上运行全局脚本的主机组。 每个对象具有以下属性： opcommand_grpid - （字符串，只读） 对象 ID；operationid - （字符串，只读） 操作 ID；groupid - （字符串） 主机组 ID。在 opcommand_hst 未被设置的情况下，被全局脚本操作所需要。 |
| opcommand_hst | array | 要在其上运行全局脚本的主机。 每个对象具有以下属性： opcommand_hstid - （字符串，只读） 对象 ID；operationid - （字符串，只读） 操作 ID；hostid - （字符串） 主机 ID；如果设置为 0 命令将运行在当前主机。在 opcommand_grp未被设置的情况下，被全局脚本操作所需要。 |
| opconditions | array | 用于触发 动作 的操作条件。 动作操作条件 如下所述。 |
| opgroup | array | 用于添加主机的主机组。 每个对象具有以下属性： operationid - （字符串，只读） 操作 ID ；groupid - （字符串） 主机组 ID 。被 "添加到主机组" 和 "从主机组删除" 操作所需要。 |
| opmessage | object | 包含有关操作发送的消息的数据的对象。 动作操作消息 对象 如下所述。 被消息操作所需要。 |
| opmessage_grp | array | 要向其发送消息的用户组。 每个对象具有以下属性： operationid - （字符串，只读） 操作 ID；usrgrpid - （字符串） 用户组 ID。在 opmessage_usr 未被设置的情况下，被全局脚本操作所需要。 |
| opmessage_usr | array | 要向其发送消息的用户。 每个对象具有以下属性： operationid - （字符串） 操作 ID；userid - （字符串） 用户 ID。在 opmessage_grp 未被设置的情况下，被全局脚本操作所需要。 |
| optemplate | array | 要将主机链接到的模板。 每个对象具有以下属性： operationid - （字符串，只读） 操作 ID；templateid - （字符串） 模板 ID 。被 "链接到模板" 和 "取消与模板的关联" 操作所需要。 |
| opinventory | object | 要将主机设置的资产模式。 对象具有以下属性： operationid - （字符串，只读） 操作 ID；inventory_mode - （字符串） 资产模式。被 "设置主机资产模式" 操作所需要。 |
动作操作消息
操作消息对象包含有关操作将发送的消息的数据。
| 属性 | 类型 | 描述 |
|---|---|---|
| default_msg | integer | 是否使用默认 action message 文本和主题。 可用值： 0 - 使用动作中的数据； 1 - （默认） 使用 媒介类型中的数据。 |
| mediatypeid | string | 将用于发送消息的媒介类型 ID。 |
| message | string | 操作消息文本。 |
| subject | string | 操作消息主题。 |
动作操作条件
动作操作条件对象定义执行当前操作时必须满足的条件。它具有以下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| opconditionid | string | （只读） 动作操作条件 ID。 |
| conditiontype （必需） |
integer | 条件类型。 可用值： 14 - 事件确认。 |
| value （必需） |
string | 与之比较的值。 |
| operationid | string | （只读） 操作 ID。 |
| operator | integer | 条件运算符。 可用值： 0 - （默认） =。 |
每个操作条件类型都支持以下运算符和值。
| 条件 | 条件名 | 支持的运算 | 期望值 |
|---|---|---|---|
| 14 | 事件确认 | = | 事件是否被确认。 可用值： 0 - 未确认； 1 - 已确认。 |
动作恢复操作
动作恢复操作对象定义在解决问题时将执行的操作。恢复操作可用于 触发器、内部 及 服务动作。它具有以下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| operationid | string | （只读） 动作操作 ID。 |
| operationtype （必需） |
integer | 操作类型。 在 触发器 和 服务 动作 的情况下可用值： 0 - 发送消息； 1 - 全局脚本； 11 - 通知所有相关人员。 在 内部 动作 的情况下可能的值： 0 - 发送消息； 11 - 通知所有相关人员。 |
| actionid | string | （只读） 这个恢复操作所属的 动作 ID 。 |
| opcommand | object | 对象包含运行的全局操作类型脚本操作的数据。 每个对象都有以下属性： scriptid - （字符串）动作类型脚本 ID。被全局脚本操作所需要。 |
| opcommand_grp | array | 要在其上运行全局脚本的主机组。 每个对象都具有以下属性： opcommand_grpid - （字符串，只读） 对象 ID；operationid - （字符串，只读） 操作 ID；groupid - （字符串） 主机组 ID 。在 opcommand_hst 未被设置的情况下，被全局脚本操作所需要。 |
| opcommand_hst | array | 要在其上运行全局脚本的主机。 每个对象都具有以下属性： opcommand_hstid - （字符串，只读） 对象 ID ；operationid - （字符串，只读） 操作 ID；hostid - （字符串） 主机 ID； 如果设置为 0 命令将运行在当前主机。在 opcommand_grp未被设置的情况下，被全局脚本操作所需要。 |
| opmessage | object | 对象包含有关恢复操作发送的消息的数据。 操作消息对象 如上所述。 被消息操作所需要。 |
| opmessage_grp | array | 要向其发送消息的用户组。 每个对象都具有以下属性： operationid - （字符串，只读） 操作 ID；usrgrpid - （字符串） 用户组 ID。在 opmessage_usr 未被设置的情况下，被消息操作所需要。 |
| opmessage_usr | array | 要向其发送消息的用户。 每个对象都具有以下属性： operationid - （字符串，只读） 操作 ID；userid - （字符串） 用户 ID。在 opmessage_grp 未被设置的情况下，被消息操作所需要。 |
动作更新操作
动作更新操作对象定义在问题更新（注释、确认、严重性更改或手动关闭）时将执行的操作。更新操作可用于 触发器 和 服务动作。它具有以下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| operationid | string | （只读）动作操作 ID。 |
| operationtype （必需） |
integer | 操作类型。 在 触发器 和 服务 动作 的情况下可能的值： 0 - 发送消息； 1 - 全局脚本； 12 - 通知所有相关人员。 |
| opcommand | object | 对象包含运行的全局操作类型脚本操作的数据。 每个对象都有以下属性： scriptid - （字符串）动作类型脚本 ID。被全局脚本操作所需要。 |
| opcommand_grp | array | 要在其上运行全局脚本的主机组。 每个对象都具有以下属性： groupid - （字符串） 主机组 ID在 opcommand_hst 未被设置的情况下，被全局脚本操作所需要。 |
| opcommand_hst | array | 要在其上运行全局脚本的主机。 每个对象都具有以下属性： hostid - （字符串） 主机 ID； 如果设置为 0 命令将运行在当前主机。在 opcommand_grp未被设置的情况下，被全局脚本操作所需要。 |
| opmessage | object | 对象包含有关更新操作发送的消息的数据。 操作消息 对象 如上所述。 |
| opmessage_grp | array | 要向其发送消息的用户组。 每个对象都具有以下属性： usrgrpid - （字符串） 用户组 ID。在 opmessage_usr 未被设置的情况下，仅被 发送消息 操作所需要。被 发送更新消息 操作所忽略。 |
| opmessage_usr | array | 要向其发送消息的用户。 每个对象都具有以下属性： userid - （字符串） 用户 ID。在 opmessage_grp未被设置的情况下，仅被 发送消息 操作所需要。被 发送更新消息 操作所忽略。 |
动作过滤
动作过滤对象定义执行配置的动作操作时必须满足的一组条件。它具有以下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| conditions (required) |
array | 用于筛选结果的过滤条件集。 |
| evaltype (required) |
integer | 过滤条件计算方法。 可用值： 0 - and/or； 1 - and； 2 - or； 3 - 自定义表达式。 |
| eval_formula | string | （只读） 生成的表达式将被用于计算过滤条件。表达式包含了通过其 ID 引用特定筛选条件的 formulaid。eval_formula 的值等于具有自定义表达式的筛选器的 formula 的值。 |
| formula | string | 用于使用自定义表达式计算过滤条件的用户定义表达式。表达式必须包含通过其 formulaid 引用特定过滤条件的 ID。表达式中使用的 ID 必须与过滤条件中定义的 ID 完全匹配：任何条件都不能保持未使用或省略状态。被自定义表达式过滤需要。 |
动作过滤条件
动作过滤条件对象定义了在运行动作操作之前必须检查的特定条件。
| 属性 | 类型 | 描述 |
|---|---|---|
| conditionid | 字符 | （只读） 动作条件 ID。 |
| conditiontype (必需) |
整数 | 条件类型。 在触发器动作的情况下可用值： 0 - 主机组； 1 - 主机； 2 - 触发器； 3 - 触发器名称； 4 - 触发器严重等级； 6 - 时间段； 13 - 主机模板； 16 - 问题被抑制； 25 - 事件标签； 26 - 事件标签值。 在 发现动作的情况下可用值： 7 - 主机 IP; 8 - 发现的服务类型； 9 - 发现的服务端口； 10 - 发现状态； 11 - 正常运行时间或停机时间； 12 - 接收到的值； 18 - 发现规则； 19 - 发现检查； 20 - 代理； 21 - 发现对象。 在自动注册动作的情况下可用值： 20 - 代理； 22 - 主机名； 24 - 主机元数据。 在内部动作的情况下可用值： 0 - 主机组； 1 - 主机； 13 - 主机模板； 23 - 事件类型； 25 - 事件标签； 26 - 事件标签值。 在服务动作的情况下可用值： 25 - 事件标签； 26 - 事件标签值； 27 - 服务； 28 - 服务名。 |
| value (必需) |
字符 | 要与之比较的值。 |
| value2 |
字符 | 要与之比较的次要值。当条件类型为 26 时被触发器，内部和服务动作所需要。 |
| actionid | 字符 | （只读） 条件所属的动作 ID。 |
| formulaid | 字符 | 用于从自定义表达式引用条件的任意唯一 ID。只能包含大写字母。ID 必须由用户在修改过滤条件时定义，但是在之后请求它们时将重新生成。 |
| operator | 整数 | 条件运算符。 可用值： 0 - （默认）等于； 1 - 不等于； 2 - 包含； 3 - 不包含； 4 - 在其中； 5 - 大于或等于； 6 - 小于或等于； 7 - 不在其中； 8 - 匹配； 9 - 不匹配； 10 - 是； 11 - 否。 |
为了更好地理解如何使用具有各种类型表达式的过滤器，查看 action.get 和 action.create 方法页面上的例子。
每种条件类型都支持以下运算符和值。
| 条件 | 条件名称 | 支持的运算符 | 期望值 |
|---|---|---|---|
| 0 | 主机组 | 等于, 不等于 |
主机组 ID。 |
| 1 | 主机 | 等于, 不等于 |
主机 ID。 |
| 2 | 触发器 | 等于, 不等于 |
触发器 ID。 |
| 3 | 触发器名称 | 包含, 不包含 |
触发器名称。 |
| 4 | 触发器严重性 | 等于, 不等于, 大于等于, 小于等于 |
触发器严重等级。参考 触发器 "严重等级" 属性 获取支持的触发器严重等级列表。 |
| 5 | 触发器值 | 等于 | 触发器值. 参考 触发器 "值" 属性 获取支持的触发器值列表。 |
| 6 | 时间段 | 在范围内, 不在范围内 | 事件触发的 时间段 。 |
| 7 | 主机IP | 等于, 不等于 |
用逗号分隔的一个或多个IP范围。参考 network discovery configuration 以获取有关支持的IP范围格式的更多信息。 |
| 8 | 发现的服务类型 | 等于, 不等于 |
发现的服务的类型。服务类型与用于检测服务的发现检查的类型匹配。参考 发现检查 "类型" 属性 获取支持的类型列表。 |
| 9 | 发现的服务端口 | 等于, 不等于 |
一个或多个以逗号分隔的端口范围。 |
| 10 | 发现状态 | 等于 | 发现对象的状态。 可能的值： 0 - 主机或服务启动； 1 - 主机或服务关闭； 2 - 主机或服务已被发现； 3 - 主机或服务失去连接。 |
| 11 | 正常运行或停机的持续时间 | 大于等于, 小于等于 |
时间，指示发现的对象处于当前状态的时间（以秒为单位）。 |
| 12 | 接收的值 | 等于, 不等于, 大于等于, 小于等于, 包含, 不包含 |
执行 Zabbix agent, SNMPv1, SNMPv2 或 SNMPv3 发现检查时返回的值。 |
| 13 | 主机模板 | 等于, 不等于 |
链接的模板ID。 |
| 16 | 问题被抑制 | Yes, No | 无需值：使用 "Yes" 运算符意味着必须抑制问题，"No" - 未抑制。 |
| 18 | 发现规则 | 等于, 不等于 |
发现规则的ID。 |
| 19 | 发现检查 | 等于, 不等于 |
发现检查的ID。 |
| 20 | 代理 | 等于, 不等于 |
代理的 ID。 |
| 21 | 发现对象 | 等于 | 触发发现事件的对象的类型。 可能的值： 1 - 发现主机； 2 - 发现服务。 |
| 22 | 主机名 | 包含, 不包含, 匹配, 不匹配 |
主机名 在自动注册条件中，运算符 匹配 和 不匹配 支持使用正则表达式。 |
| 23 | 事件类型 | 等于 | 特定的内部事件。 可能的值： 0 - 监控项处于 "不支持" 状态； 1 - 监控项处于 "正常" 状态； 2 - LLD 规则处于 "不支持" 状态； 3 - LLD 规则处于 "正常" 状态； 4 - 触发器处于 "未知" 状态； 5 - 监控项处于 "正常" 状态。 |
| 24 | 主机元数据 | 包含, 不包含, 匹配, 不匹配 |
自动注册主机的元数据。 运算符 匹配 和 不匹配 支持使用正则表达式。 |
| 25 | 标签 | 等于, 不等于, 包含, 不包含 |
事件标签。 |
| 26 | 标签值 | 等于, 不等于, 包含, 不包含 |
事件标签值。 |
| 27 | 服务 | 等于, 不等于 |
服务 ID。 |
| 28 | 服务名 | 等于, 不等于 |
服务名称。 |