task.create
描述
object task.create(object/array tasks)
此方法允许create新任务（例如收集诊断数据 或检查监控项或无需重新加载配置的低级发现规则）。
此方法仅适用于超级管理员用户类型。 调用该方法的权限可在用户角色设置中撤销。详见 User roles 获取更多信息。
参数
(object/array) 一个用于create的任务.
该方法接受以下参数.
| 参数 | 数据类型 | 描述 |
|---|---|---|
| type (required) | integer | 任务类型. 可能的值: 1 - 诊断信息; 6 - 立即检查. |
| request (required) | object | 根据任务类型的任务请求object. 请求object的正确格式在Task object部分描述. |
| proxy_hostid | integer | Proxy关于诊断信息任务将收集的数据. 对于'立即检查'任务忽略此参数. |
注意 '立即检查'任务只能为以下类型的监控项/发现规则创建:
- Zabbix agent
- SNMPv1/v2/v3 agent
- 简单检查
- 内部检查
- 外部检查
- 数据库监控
- HTTP agent
- IPMI agent
- SSH agent
- TELNET agent
- 计算检查
- JMX agent
返回值
(object) 返回一个包含所创建任务ID的object 在taskids属性下。为每个监控项创建一个任务 低级发现规则。返回的ID顺序与 传递的itemids顺序
示例
创建任务
为两个监控项创建任务check now。一个是监控项，另一个是低级发现规则。
请求:
{ "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 6, "request": { "itemid": "10092" } }, { "type": "6", "request": { "itemid": "10093" } } ], "auth": "700ca65537074ec963db7efabda78259", "id": 1 }响应:
创建diagnostic information任务。
请求:
{ "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 1, "request": { "alerting": { "stats": [ "alerts" ], "top": { "media.alerts": 10 } }, "lld": { "stats": "extend", "top": { "values": 5 } } }, "proxy_hostid": 0 } ], "auth": "700ca65537074ec963db7efabda78259", "id": 2 }响应:
另请参阅
来源
CTask::create() 位于 ui/include/classes/api/services/CTask.php 文件中。