task.create

描述

object task.create(object/array tasks)

此方法允许create任务.

该方法适用于所有类型的用户（自Zabbix 7.0.19起对Admin和User类型用户开放）。调用该方法的权限可在用户角色设置中撤销。更多信息请参阅User roles.

参数

(object/array) 一个用于create的任务.

该方法接受具有任务对象的任务.

请注意'立即执行'任务只能为以下类型的监控项/发现规则创建:

Zabbix agent (被动式)
简单检查
SNMP agent (v1/v2/v3)
Zabbix内部
外部检查
数据库监控
HTTP agent
IPMI agent
SSH agent
TELNET agent
JMX agent
计算型
依赖型监控项
脚本
浏览器

如果监控项/发现规则是"依赖型监控项"类型，那么它的主监控项也必须是上述类型之一。

返回值

(object) 返回一个 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
       }

为两个proxies创建'刷新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
       }

另请参阅

来源

ui/include/classes/api/services/CTask.php 中的 CTask::create()。

Documentation

task.create

描述

参数

返回值

示例

创建任务

另请参阅

来源