On this page
创建
描述
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 文件中。