创建

描述

object task.create(object/array tasks)

该方法允许创建新任务(例如收集诊断数据或检查监控项或低级别发现规则,而无需重新加载配置)。

这个方法只有 超级管理员 用户类型可以使用。在用户角色设置中可用撤销掉用该方法的权限。查看用户角色获取更多信息。

参数

(object/array) 任务创建。

该方法接受具有 标准任务属性.

请注意,‘立即执行’ 任务只能针对以下类型的项目/发现规则创建:

  • Zabbix agent
  • SNMPv1/v2/v3 agent
  • Simple check
  • Internal check
  • External check
  • Database monitor
  • HTTP agent
  • IPMI agent
  • SSH agent
  • TELNET agent
  • Calculated check
  • JMX agent
  • Dependent item

如果监控项或发现规则是“依赖项目”的类型,则顶级主项目必须是以下类型之一:

  • Zabbix agent
  • SNMPv1/v2/v3 agent
  • Simple check
  • Internal check
  • External check
  • Database monitor
  • HTTP agent
  • IPMI agent
  • SSH agent
  • TELNET agent
  • Calculated check
  • JMX agent

返回值

(object)taskids 属性下返回一个包含创建的任务ID的对象。每个监控项和低级别发现规则都会创建一个任务。返回的ID顺序与传递的 itemids 的顺序相匹配。

示例

创建任务

给两个监控项创建一个 立即执行 的任务。一个是一个监控项,另一个是一个低级别发现规则。

请求:

{
           "jsonrpc": "2.0",
           "method": "task.create",
           "params": [
               {
                   "type": 6,
                   "request": {
                       "itemid": "10092"
                   }
               },
               {
                   "type": 6,
                   "request": {
                       "itemid": "10093"
                   }
               }
           ],
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "taskids": [
                   "1",
                   "2"
               ]
           },
           "id": 1
       }

为2个Proxy 创建任务 刷新代理配置

请求:

{
           "jsonrpc": "2.0",
           "method": "task.create",
           "params": [
               {
                   "type": 2,
                   "request": {
                       "proxyids": ["10459", "10460"]
                   }
               }
           ],
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "taskids": [
                   "1"
               ]
           },
           "id": 1
       }

创建任务 诊断信息

请求:

{
           "jsonrpc": "2.0",
           "method": "task.create",
           "params": [
               {
                   "type": 1,
                   "request": {
                       "alerting": {
                           "stats": [
                               "alerts"
                           ],
                           "top": {
                               "media.alerts": 10
                           }
                       },
                       "lld": {
                           "stats": "extend",
                           "top": {
                               "values": 5
                           }
                       }
                   },
                   "proxyid": 0
               }
           ],
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "taskids": [
                   "3"
               ]
           },
           "id": 1
       }

参阅

来源

CTask::create() 在 ui/include/classes/api/services/CTask.php.