获取

描述

integer/array task.get(object **parameters**)

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

该方法在 Zabbix 5.0.5以后的版本可用。

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

参数

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

该方法支持以下参数。

参数类型描述
taskidsstring/array返回给定ID的task信息。
outputquery这些参数对于所有“get”方法都是通用的，在 参考说明desk中有详细描述。
preservekeysboolean

返回值

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

示例

通过ID获取task

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

请求:

  1. {
  2.     "jsonrpc": "2.0",
  3.     "method": "task.get",
  4.     "params": {
  5.         "output": "extend",
  6.         "taskids": "1"
  7.     },
  8.     "auth": "038e1d7b1735c6a5436ee9eae095879e",
  9.     "id": 1
  10. }

相应:

  1. {
  2.     "jsonrpc": "2.0",
  3.     "result": [
  4.         {
  5.             "taskid": "1",
  6.             "type": "7",
  7.             "status": "3",
  8.             "clock": "1601039076",
  9.             "ttl": "3600",
  10.             "proxy_hostid": null,
  11.             "request": {
  12.                 "alerting": {
  13.                     "stats": [
  14.                         "alerts"
  15.                     ],
  16.                     "top": {
  17.                         "media.alerts": 10
  18.                     }
  19.                 },
  20.                 "lld": {
  21.                     "stats": "extend",
  22.                     "top": {
  23.                         "values": 5
  24.                     }
  25.                 }
  26.             },
  27.             "result": {
  28.                 "data": {
  29.                     "alerting": {
  30.                         "alerts": 0,
  31.                         "top": {
  32.                             "media.alerts": []
  33.                         },
  34.                         "time": 0.000663
  35.                     },
  36.                     "lld": {
  37.                         "rules": 0,
  38.                         "values": 0,
  39.                         "top": {
  40.                             "values": []
  41.                         },
  42.                         "time": 0.000442
  43.                     }
  44.                 },
  45.                 "status": "0"
  46.             }
  47.         }
  48.     ],
  49.     "id": 1
  50. }

更多参考

源码

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