获取
描述
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.