动作对象
动作对象
动作对象具有以下属性。
动作操作对象定义了一个将在执行动作时执行的操作，具有以下属性。
属性类型描述operationtypeinteger操作类型。可能值：0 - 发送消息；1 - 全局脚本；2 - 添加主机；3 - 移除主机；4 - 添加到主机组；5 - 从主机组移除；6 - 链接到模板；7 - 取消链接模板；8 - 启用主机；9 - 禁用主机；10 - 设置主机资产模式；13 - 添加主机标签；14 - 移除主机标签。如果的eventsource设置为”由触发器创建的事件”或”基于服务状态更新创建的事件”，则可能值有：0 - “发送消息”；1 - “全局脚本”。如果动作对象的eventsource设置为”内部事件”，则可能值有：0 - “发送消息”。:- 必需esc_periodstring升级步骤的持续时间（秒）。必须大于60秒。接受秒数、带后缀的时间单位或用户宏。如果设置为0或0s，将使用默认的动作作为升级周期。默认值：0s。属性行为:- 如果的eventsource设置为”由触发器创建的事件”、”内部事件”或”基于服务状态更新创建的事件”，则支持esc_step_frominteger开始升级的步骤。默认值：1。属性行为:- 如果的eventsource设置为”由触发器创建的事件”、”内部事件”或”基于服务状态更新创建的事件”，则支持esc_step_tointeger结束升级的步骤。默认值：1。属性行为:- 如果的eventsource设置为”由触发器创建的事件”、”内部事件”或”基于服务状态更新创建的事件”，则支持evaltypeinteger操作条件的评估方法。可能值：0 - (默认) AND / OR；1 - AND；2 - OR。opcommandobject要执行的全局脚本。全局脚本必须定义scriptid属性。属性行为:- 如果operationtype设置为”全局脚本”，则必需opcommand_grparray运行全局脚本的主机组。主机组必须定义groupid属性。:- 如果operationtype设置为”全局脚本”且未设置opcommand_hst，则必需opcommand_hstarray运行全局脚本的主机。主机必须定义hostid属性。属性行为:- 如果operationtype设置为”全局脚本”且未设置opcommand_grp，则必需opconditionsarray用于触发器动作的操作条件。操作条件对象的。opgrouparray要添加主机的主机组。主机组必须定义groupid属性。属性行为:- 如果operationtype设置为”添加到主机组”或”从主机组移除”，则必需opmessageobject包含由操作发送的消息数据的对象。操作消息对象在。属性行为:- 如果operationtype设置为”发送消息”，则必需opmessage_grparray发送消息的用户组。用户组必须定义usrgrpid属性。:- 如果operationtype设置为”发送消息”且未设置opmessage_usr，则必需opmessage_usrarray发送消息的用户。用户必须定义userid属性。属性行为:- 如果operationtype设置为”发送消息”且未设置opmessage_grp，则必需optemplatearray链接到主机的模板。模板必须定义templateid属性。:- 如果operationtype设置为”链接模板”或”取消链接模板”，则必需opinventoryobject设置主机的库存模式。库存必须定义属性。属性行为:- 如果operationtype设置为”设置主机库存模式”，则必需optagarray要添加或删除的主机标签。标签必须定义tag属性。value属性是可选的。:- 如果operationtype设置为”添加主机标签”或”删除主机标签”，则支持
动作操作消息操作消息对象包含有关将由动作发送的消息的数据。它具有以下属性。
属性描述default_msginteger是否使用默认的动作消息文本和主题。可能的值：0 - 使用来自动作的数据；1 - (默认) 使用来自媒体类型的数据。mediatypeidID用于发送消息的媒体类型的ID。属性行为:- 如果、动作恢复操作对象、或的operationtype设置为”发送消息”，或者如果动作更新操作对象的operationtype设置为”通知所有相关人员”，则支持messagestring动作消息文本。:- 如果default_msg设置为”使用来自动作的数据”，则支持subjectstring动作消息主题。属性行为:- 如果default_msg设置为”使用来自动作的数据”，则支持
动作操作条件
每种操作条件类型都支持以下操作符和值。
条件条件名称支持的操作符预期值14事件已确认=事件是否已确认。可能的值：0 - 未确认；1 - 已确认。
动作恢复操作对象定义了在问题得到解决时将执行的操作。 恢复操作仅适用于触发器、内部和服务动作。 它具有以下属性。
属性描述operationtypeinteger操作类型。如果动作对象的eventsource设置为”由触发器创建的事件”或”服务状态更新时创建的事件”：0 - 发送消息；1 - 全局脚本；11 - 通知所有相关人员。如果的eventsource设置为”内部事件”：0 - 发送消息；11 - 通知所有相关人员。属性行为:- 必填opcommandobject要执行的全局脚本。全局脚本必须定义scriptid属性。:- 如果operationtype设置为”全局脚本”，则必填opcommand_grparray运行全局脚本的主机组。主机组必须定义groupid属性。属性行为:- 如果的eventsource设置为”由触发器创建的事件”，并且operationtype设置为”全局脚本”，且未设置opcommand_hst，则必填opcommand_hstarray运行全局脚本的主机。主机必须定义hostid属性。属性行为:- 如果的eventsource设置为”由触发器创建的事件”，并且operationtype设置为”全局脚本”，且未设置opcommand_grp，则必填opmessageobject包含恢复操作发送的消息数据的对象。操作消息对象在上面详细描述。:- 如果operationtype设置为”send message”，则必填opmessage_grparray要发送消息的用户组。用户组必须定义usrgrpid属性。属性行为:- 如果operationtype设置为”send message”且未设置opmessage_usr，则必填opmessage_usrarray要发送消息的用户。用户必须定义userid属性。:- 如果operationtype设置为”send message”且未设置opmessage_grp，则必填
动作更新操作对象定义了在问题更新（评论、确认、严重性变更或手动关闭）时将执行的操作。 更新操作仅适用于触发器和服务动作。 它具有以下属性。
属性类型描述conditionsarray通过设置来得到想要的结果。条件将按照它们在公式中的放置顺序进行排序。属性行为:- 必填evaltypeinteger过滤条件评估方法。可能的值：0 - and/or（并且/或者）；1 - and（并且）；2 - or（或者）；3 - 自定义表达式。:- 必填eval_formulastring用于评估过滤条件的生成表达式。表达式包含通过其formulaid引用特定过滤条件的ID。eval_formula的值等于具有自定义表达式的过滤的formula的值。属性行为:- 只读formulastring用户定义的表达式用于评估过滤器条件的自定义表达式，并且这个表达式需要包含引用特定过滤器条件的 formulaid。在创建用户定义的表达式以评估过滤器条件的场景中，确保表达式中使用的ID与过滤器条件中定义的ID完全匹配，并且没有条件被遗漏或未使用，是一个重要的验证步骤。:- 如果evaltype设置为”自定义表达式”，则必填
动作过滤条件动作过滤条件对象定义了在执行动作操作之前必须检查的具体条件。
属性描述conditiontypeinteger条件的类型。如果动作对象的eventsource设置为”由触发器创建的事件”，则可能的值有：0 - 主机组；1 - 主机；2 - 触发器；3 - 事件名称；4 - 触发器严重级别；6 - 时间段；13 - 主机模板；16 - 问题已被抑制；25 - 事件标签；26 - 事件标签值。如果的eventsource设置为”由发现规则创建的事件”，则可能的值有：7 - 主机IP；8 - 已发现的服务类型；9 - 已发现的服务端口；10 - 发现状态；11 - 运行持续时间或宕机持续时间；12 - 接收到的值；18 - 发现规则；19 - 发现检查；20 - 代理；21 - 发现对象。如果动作对象的eventsource设置为”由active agent自动注册创建的事件”，则可能的值有：20 - proxy；22 - 主机名；24 - 主机元数据。如果的eventsource设置为”内部事件”，则可能的值有：0 - 主机组；1 - 主机；13 - 主机模板；23 - 事件类型；25 - 事件标签；26 - 事件标签值。如果动作对象的eventsource设置为”基于服务状态更新创建的事件”，则可能的值有：25 - 事件标签；26 - 事件标签值；27 - 服务；28 - 服务名称。:- 必填valuestring要与之比较的值。属性行为:- 必填value2string要与之比较的次要值。:- 如果动作对象的eventsource设置为”由触发器创建的事件”，conditiontype设置为触发器动作的任何可能值，并且条件类型（见下文）为”26”，则为必填- 如果的eventsource设置为”内部事件”，conditiontype设置为内部动作的任何可能值，并且条件类型（见下文）为”26”，则为必填- 如果动作对象的设置为”基于服务状态更新创建的事件”，conditiontype设置为服务动作的任何可能值，并且条件类型（见下文）为”26”，则为必填formulaidstring用于从自定义表达式中引用条件的任意唯一ID。只能包含大写字母。在修改过滤条件时，ID必须由用户定义，但在之后请求它们时将重新生成。operatorinteger条件操作符。可能的值：0 - (默认) 等于；1 - 不等于；2 - 包含；3 - 不包含；4 - 在…内；5 - 大于或等于；6 - 小于或等于；7 - 不在…内；8 - 匹配；9 - 不匹配；10 - 是；11 - 否。
为了更好地了解如何使用具有各种类型表达式的过滤，请参阅和action.create方法页面的示例。
每个条件类型都支持以下运算符和值。