这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

获取

描述

integer/array task.get(object parameters)

task.get方法可以根据给定的参数获取task信息。 方法只返回有关“诊断信息”任务的详细信息。

<note note>该方法在 Zabbix 5.0.5以后的版本可用。 :::

对于非超级管理员用户,方法返回权限不足消息。

参数

(object) 参数定义了所需的输出。

该方法支持以下参数。

参数 [ 型](/zh/manual/api/reference_commentary#data_types) 描述
taskids string/array 返回给定ID的task信息。
output query 这些参数对于所有“get”方法都是通用的,在 参考说明desk中有详细描述。
preservekeys boolean

返回值

(integer/array) 返回一个对象的数组。

示例

通过ID获取task

获取 task “1”的所有数据。

请求:

{
           "jsonrpc": "2.0",
           "method": "task.get",
           "params": {
               "output": "extend",
               "taskids": "1"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

相应:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "taskid": "1",
                   "type": "7",
                   "status": "3",
                   "clock": "1601039076",
                   "ttl": "3600",
                   "proxy_hostid": null,
                   "request": {
                       "alerting": {
                           "stats": [
                               "alerts"
                           ],
                           "top": {
                               "media.alerts": 10
                           }
                       },
                       "lld": {
                           "stats": "extend",
                           "top": {
                               "values": 5
                           }
                       }
                   },
                   "result": {
                       "data": {
                           "alerting": {
                               "alerts": 0,
                               "top": {
                                   "media.alerts": []
                               },
                               "time": 0.000663
                           },
                           "lld": {
                               "rules": 0,
                               "values": 0,
                               "top": {
                                   "values": []
                               },
                               "time": 0.000442
                           }
                       },
                       "status": "0"
                   }
               }
           ],
           "id": 1
       }

更多参考

源码

CTask::get() in ui/include/classes/api/services/CTask.php.