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