我的书签
添加书签
移除书签创建
描述
object action.create(object/array actions)
此方法允许创建新的动作。
此方法仅对Admin和Super admin用户类型可用。可以在用户角色设置中撤销调用此方法的权限。更多信息请参见用户角色。
参数
(object/array) 要创建的动作。
除了标准动作属性外，该方法还接受以下参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| filter | object | 动作过滤 对象，用于指定动作筛选条件。 |
| operations | array | 动作操作 数组，为动作创建的操作。 |
| recovery_operations | array | 动作恢复操作 数组，为动作创建的恢复操作。 |
| update_operations | array | 动作更新操作 数组，为动作创建的更新操作。 |
返回值
(object) 返回一个对象，该对象在actionids属性下包含已创建动作的ID。返回的ID顺序与传递的动作顺序相匹配。
示例
创建触发器动作
创建一个触发器动作，该动作将在主机ID为”10084”上的触发器（名称中包含”memory”）进入PROBLEM状态时开始执行。该动作将配置4个操作。 - 第一个也是立即执行的操作，将通过媒体类型”1”向用户组ID为”7”中的所有用户发送消息。 - 如果事件在30分钟内未解决，第二个操作将在组”2”中的所有主机上运行脚本“5”（来自”动作操作”按钮创建的脚本）。 - 如果事件得到解决，所有与该问题相关的用户将收到一个恢复操作通知。 - 如果事件被更新，所有与该问题相关的用户将收到一个确认/更新操作通知。
请求:
{"jsonrpc": "2.0","method": "action.create","params": {"name": "Trigger action","eventsource": 0,"esc_period": "30m","filter": {"evaltype": 0,"conditions": [{"conditiontype": 1,"operator": 0,"value": "10084"},{"conditiontype": 3,"operator": 2,"value": "memory"}]},"operations": [{"operationtype": 0,"esc_step_from": 1,"esc_step_to": 1,"opmessage_grp": [{"usrgrpid": "7"}],"opmessage": {"default_msg": 1,"mediatypeid": "1"}},{"operationtype": 1,"esc_step_from": 2,"esc_step_to": 2,"opconditions": [{"conditiontype": 14,"operator": 0,"value": "0"}],"opcommand_grp": [{"groupid": "2"}],"opcommand": {"scriptid": "5"}}],"recovery_operations": [{"operationtype": "11","opmessage": {"default_msg": 1}}],"update_operations": [{"operationtype": "12","opmessage": {"default_msg": 0,"message": "Custom update operation message body","subject": "Custom update operation message subject"}}]},"id": 1}
响应:
{"jsonrpc": "2.0","result": {"actionids": ["17"]},"id": 1}
创建一个发现动作
创建一个发现动作，该动作将模板”10001”链接到已发现的主机。
请求:
{"jsonrpc": "2.0","method": "action.create","params": {"name": "Discovery action","eventsource": 1,"filter": {"evaltype": 0,"conditions": [{"conditiontype": 21,"operator": 0,"value": "1"},{"conditiontype": 10,"operator": 0,"value": "2"}]},"operations": [{"operationtype": 6,"optemplate": [{"templateid": "10001"}]}]},"id": 1}
响应:
{"jsonrpc": "2.0","result": {"actionids": ["18"]},"id": 1}
使用自定义表达式过滤
创建一个触发器动作，该动作使用自定义表达式 - “A and (B or C)” - 来评估动作条件。 一旦来自主机”10084”或主机”10106”的告警级别大于等于”Warning”触发器将进入PROBLEM状态， 该动作将通过媒体类型”1”向用户组”7”中的所有用户发送消息。 公式ID “A”、”B” 和 “C” 是任意选择的。
请求:
{"jsonrpc": "2.0","method": "action.create","params": {"name": "Trigger action","eventsource": 0,"esc_period": "15m","filter": {"evaltype": 3,"formula": "A and (B or C)","conditions": [{"conditiontype": 4,"operator": 5,"value": "2","formulaid": "A"},{"conditiontype": 1,"operator": 0,"value": "10084","formulaid": "B"},{"conditiontype": 1,"operator": 0,"value": "10106","formulaid": "C"}]},"operations": [{"operationtype": 0,"esc_step_from": 1,"esc_step_to": 1,"opmessage_grp": [{"usrgrpid": "7"}],"opmessage": {"default_msg": 1,"mediatypeid": "1"}}]},"id": 1}
响应:
{"jsonrpc": "2.0","result": {"actionids": ["18"]},"id": 1}
创建 agent 自动注册规则
创建一个自动注册动作，当主机名包含“SRV”或元数据包含“AlmaLinux”时，将该主机添加到主机组“2”中。
请求:
{"jsonrpc": "2.0","method": "action.create","params": {"name": "Register Linux servers","eventsource": "2","filter": {"evaltype": "2","conditions": [{"conditiontype": "22","operator": "2","value": "SRV"},{"conditiontype": "24","operator": "2","value": "AlmaLinux"}]},"operations": [{"operationtype": "4","opgroup": [{"groupid": "2"}]}]},"id": 1}
响应:
{"jsonrpc": "2.0","result": {"actionids": [19]},"id": 1}
创建带有主机标签的代理自动注册规则
创建一个自动注册动作，将主机添加到主机组”2”并添加两个主机标签。
请求:
{"jsonrpc": "2.0","method": "action.create","params": {"name": "Register Linux servers with tags","eventsource": "2","operations": [{"operationtype": "4","opgroup": [{"groupid": "2"}]},{"operationtype": "13","optag": [{"tag": "Location","value": "Office"},{"tag": "City","value": "Riga"}]}]},"id": 1}
响应:
{"jsonrpc": "2.0","result": {"actionids": [20]},"id": 1}
另请参阅
源码位置
CAction::create() 在 ui/include/classes/api/services/CAction.php 文件中。
